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The Buiid J update of the Integration Procedures Notebook 
is now available. Copies of this document may be obtained via 
the following command sequence? 


ATTACHs TPNDOC/UN=DEVI 
SES.PRINT IPNDGC 


Change pages are not being distributed for this level (Cas 
has been suggested) due to the fact that the voiume of change 
pages is only sligtiy smaller than the document itself. Some 
highlights of this revision are as follows: 


~ Section 1 has been reduced in size as the information in 
this section was either inaccurate or out of date. 

—- Several procedure updates have been documented in Section 
29 and Section 3 has been corrected or clarification added 
where necessary 

- The current Regression tests and test sequence has been 
documented in Section 42 The source of the tests as they are 
actually run has been replicated heres and the test sequence 
is exactiy that used by the [Integration project at this 
level. 

~ The NOS/VE Transmittal Form has been changed to provide 
more information to the analyst transmitting code. 

- The jiatest version of the $2 Machine Usage Document (lor 
"Helpful Hints®™) has been picked up as Appendix E» 
Information in this document takes precedence over that iin 
Appendix F as it is more up to date. 

- Appendix F has been reduced in size considerablys as 
redundant and inaccurate information has been deteted. The 
information in this Appendéx still reflects much of the HCS 
syntax and conventionss some of which are still valid for 
NOS/VE at this level. | : 
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1.0 OVERVIEW OF INTEGRATION. PROCESS 


The Integration process begins with the transmittal of a 
software products the command tanguage procedures required to 
buijiitd the products installation procedure documentations and 
baseline documentation From the software development 
organization. Subsequent to this transmittails the Integration 
project is responsibie for maintaining the program tlibrarys 
standardizing the installation proceduress maintaining the 
installation procedure documentations and preparing the 
software release package for the Software Manufacturing and 
Distribution organization. In the interim time between the 
initial transmittal and the release of a software products the 
Integration project schedules periodic buiidse. The outputs 
from these builds are detivered to software development and 
test organizations and/or made part of the software release 
packages 


1.20.1 RELATED DOCUMENTS 


Document Title Distributor 
NOS/VE Procedures and Conventions SeW. Fewer 
NOS/VE User'®s Guide Appendix F 
NOS7VE Command Interface ERS DCS —- ARH3609 
NOS/VE Program Interface ERS DCS —- ARH3610 
SES User*s Handbook DCS —- ARH1833 
CYBER 180 System Interface Standard DCS — $2196 
Simulated NOS/VE Program Interfaces ERS DCS — ARH3125 
VEGEN ERS DCS ~— ARH2591 
VELINK ERS DCS ~ ARH2816 
CYBIL Language Specification DCS — ARH2298 
CYBER 180 CPU Assembler ERS DCS — ARH1693 
CYBER 180 Simulator ERS DCS — ARH1729 
SES Procedure Writers Guide DCS — ARH2894 
CYBER 180 Object Code Utilities ERS DCS — ARH2922 


Source Code Utility ERS DCS — ARH1766 


aoe 


ae oe 
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120.2 STANDARDS 


In order to facilitate the Installation processs certain 
standards will have to be set and adhered to by atl members of 
the Qperating System and Product Set. These standards {to be 
defined in the Systems Interface Standard) will cover the 
Following items: 


a) All program tibraries will have the same formats this 
will be defined by (TBD). 


b} Alt output tapes will conform to some predetermined 
format in terms of numbers of files and what each File 
will contains This will be defined by (TBD). 


c) The above formats are intended to facilitate 
establishment of proceduralized installation decks. 
This implies that some convenient. naming conventions 
must be observed. These conventions will be defined 
by (TBD). 
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22021 INTRODUCTION 


The command language procedures corresponding to NOS/VE 
buifids all reside in the INTl» INT2s, or DEVI catalogs 
depending upon the desired level of verification the system 
has attained. It is assumed that the DEVI tevel = of 
verification is the minimum tevel of system verification 
required by most userss therefore the DEVI catatiog is 
frequentiy referenced in the remainder of this section. (A 
description of the catalog management policies employed for 
NOS/7VE follows.) To obtain a listing of the complete set of 
command language procedures provided in the Integration 
catalogs execute the following command language sequence? 


ACQUIRE» PROCLIB/UN=<Integr ation_Catalog> 
SES»PRINT PROCLIB | 


Before running the build procedures as batch jobss a check 
must be made to insure that the user number under which the 
job will run has sufficient validation limits for the job to 
execute. The minimum values for certain timits must be as 
follows: 


24378 

unlimited 

unlimited 

4096 

2008 (if simulator is to use LCM) 

unlimited (each library is built via batch job) 


o 
Te) 
fiw ww oH ff 


The current values may be obtained with the LIMITS control! 
carde If they are not large enoughs have the operations staff 
change them. 


220.2 CATALOG MANAGEMENT POLICIES 


The catalog management function done by the Integration 
project approximates the cycle concept of permanent file 
management. New system files begin in the INTL catatog and 
move to the INT2 and DEV1 catalogs as some significant 
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verification milestone has been achieved. Each catatog is 
intended to be self-containeds in that procedures executed 
from either catalog will access onty those files which have 
the same level of verification associated with them. The INT1 
catalog will access the most recent compiterss SES toolss 
etc. while the INT2 catalog only contains selected system 
files from the tast “stabie™ interim buiid which will 
deadstart and run a minimum set of test cases.» The DEVI 
catalog represents the "frozen" catalog for which changes are 
no ftonger being accepted (this is typically a snapshot of the 
fast build cycie). The DEVI catalog wil! change no more 
frequently than once for each build cycle. The INT2 catatog 
will change only as Frequentiy as bug fixes or system upgrades 
demands with the objective of keeping this cataiog no more 
than one week out of synchronization with the INT1 catalog. 
The INTL catalogs howevers is a *"working catalog” for the 
debug of new system fixes» new proceduressy etce The stability 
of this catalog cannot be predicted. 


201 SOURCE MAINTENANCE PROCEDURES 


This section is being replaced by a user's guide which is 
targeted for inclusion as one of the appendices to this 
document. The procedures being developed are based upon the 
prototype Source Code Utility which is being made available in 
SES Release 14. 


202 EULL_ SYSTEM BUILDS 


2e2e1 INTRODUCTION 


The basic version of NOS/VE consists of 5 base object files 
(XLMMTRs XLJLIFs XLJ12Fs XLJ13F. XLJIFF)> the CYBIL runtime 
routine library (CYBILIB)» and several user program 
fibraries. The general scheme used in modifying or reptacing 
existing modules and adding nen modutes is to apply the 
changes to the appropriate base object text file and save this 
modified file in the current catalog. The checkpoint file 
build procedure NOSLINK will always attempt to obtain updated 
object text files from the current user's catalog before it 
attempts to get them from the [Integration catalogs thereby 
allowing a user to replace these object text files with his 
owne, The "quick link" option of NOSLINK cannot be used when 
modifying the base object text files as It does not use these. 
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directiys but rather a pre~linked form of these files. 
2e2e2 NOS/VE PARTITIONING 


The system can. be thought of as being partitioned into two 
sections consisting of the five object files mentioned 
Previously» Each partition has associated with it certain 
protections privilege and responsibility. The first partition. 
consists of those routines that run in monitor mode and is 
known as the monitor. The second partition consists of those 
routines that run in job mode and is Known as task servicess 
The modules on file XLMMTR make up the monitors and the 
modules on Files XLJ11Fs XLJ12Fs XLJI1L3F and XLJIFF make up 
task servicess A singte user task can perhaps be thought of 
as a third type of partition. 


Any XDCL'd symbol within a given partition can be XREF‘d by 
any modufe within the same partition. To aliow other 
partitions to XREF these same symbols» the symbols must be 
gated. Gating a symbofl only makes the symbol available to 
other partitions during the linking processs it does not 
necessarily mean that the xXDCL*d tocation can actually be 
referenced - that is controlled by the ring brackets. In 
generals only selected XDCLYtd symbo!s are gated. Refer to the 
MAP_offset_K file for a list of the entry points avaitabie to 
a user task. This list of entry points preceeds the linkage 
of user tasks and is entitited "“INBDARD SYMBOL TABLE ENTRY 
POINTS FROM FILE : STSXGOST™". It should also be noted that a 
Similar list exists for the Monitor entry points availabie to 
Task Services and is entitied similarly with the substitution 
of MTRXOST for STSXOST in the above title. 


2020201 XLMMIR 


The packed object text file XLMMTR contains all modules 
which run in monitor mode. Modules from this file execute in 
fing 1 of monitor and have a ring bracket of (1lsilsl1). They 
also execute with global privilege. 

The following modules reside in monitor: 


CPMTR 
SYSTEM_MONITOR 
SIGNAL_MONITOR 
CPERR 
MMMSMEMORY_MANAGER_MONITOR_MODE 
CIPSCOMMON_INPUT_DUTPUT 
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FAPSFILE_ALLOCATIGN MANAGER 
SQP $SEQUENC E_ MANAGER 
CMS$CONFIGURATION_ MANAGER 
CPMCB 

KPPRDC | 
TMMSMTR_FLAG_SIGNAL_FUNCTIONS 
MEMORY_LINK_MONITOR_MODE 
MMMASM 

OSAINX 

TMMSDISPATCHER 

MTMSSERVICE_ ROUTINES 
MSMSMCU_REQUEST_PROCESSOR 


2e2e2e2 XLJLIE 


The packed object text file XLJLIF contains al! modules 
which run in ring 1 task servicese Modules from this file 
execute in ring 1 and have a ring bracket of (lslsF). 

The fotlowing modules reside in ring 1 task services? 


MISC_SERVICES_RING_1 
MEMORY _ MANAGER 

SYSTEM _ROUTINE_JOB_MODE 
CONSOLE_DISPLAY_MANAGER 
FILE _MANAGER 

MDUST 

DMP SSYSTEM_INITIALIZATION 
JOB_DEADSTART 

QUEVED_FILE MODULE 
INTTIALIZE_MEMORY_LINK 
MEMORY_LINK_INTERFACE 
KPPROC 

OFMSB_ DISPLAY MANAGER 
TMMSDISPOSE_GF_LRING1_PREEMPTS 
MLPS$C17O_HELPER 
TMMSMANAGE_ SIGNALS 
DOSMS$INITIALIZE_TABLES 
MMMSSEGMENT_SIGNAL_HANDLER 
QUEVE_FILE_INTERNAL_INTERFACES 
STMSMODIFY_AST_R1 
STMSREADLAST_R1I 
DMMSKEEP_MVT 
DMM$R1_MODIFY_MVT 
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2e2e2e3 XLIIZE 


The packed object text file XLJ12F contains all. modules 
which run in ring 2 task services. Moduftes from this file 
execute in ring 2 and have a ring bracket of (1s2s5F). | 

The following modules reside in ring 2 task services? 


JBTBLS 

DMPSJOB_LINIT 

SEGMENT_ MANAGER 
PROGRAM_LOADER 
SIGNAL_HANDLING_ ROUTINES 

TASK MANAGER 
EXECUTE _ PROCESSOR 
LGOM$LOCAL_LOG_MANAGER 

TM2_ COMMAND INTERFACE 
LOGICAL_NAME_SPACE_MANAGER 
TMMSALLOCATE_EXECUTION_RINGS 
TMMSDISPOSE_OF_RING2_PREEMPTS 
TMMSGET_ MONITOR FAULT 

TMM SMANAGE_PREEMPTIVE_BUFFERS 
JOBLINITIATOR 

JOB_MONITOR 

JOBLTERMINATOR 

JM_PROC_R2 
CLMS$READ_LINPUT_FILE 
LUMSSAVE_LINK_USER_DESCRIPTOR 
MLMDDS 
TMMSCLEAR_WATT_INHIBITED 
PMMSDEFAULT_LOADER_PARAM_MGMT_2 
FMMSLOCAL_NAME_TABLE_MANAGER 
FMMSTABLES 

INTERAC TIVE_USER 
TIMS$REPORT_UNHANDLED_DATA_MSG 
TIMSTIME_WAIT 
TIMS$REPORT_UNHANDLED_SUPER_MSG 
TIM$REPORT_STATUS_ERROR 
TIMSREPORT_LOGICAL_ERROR 
IIM$ASCIL_170_TO_HEX 
STMSMODIFY_VST_R2 
STM$READ_VST_R2 
STMSMODIFY_JOBLASSOC_CAT 
STM$READ_JOBLASSOC_CAT 
STMSMODIFY_JOB_SET_TABLE 
STMS$READ_JOB_SET_TABLE 
STMS$SET_END_JOB 

STMSGET_MOD 
STMS$RING2_CREATE_SET 


. 


oe Oe we be 


Se O64 2H Ch 4 2H Oh 6b 4H be OH O64 2H BH 64 BE OH CH BE 2H GH HH 4H 4H BH HE KK BH BE BH 4H CH 2H BE KH HE BE OH BH HE BH EO 


2-6 
ADVANCED SYSTEMS INTEGRATION PROCEDURES NOTEBOOK 
2.0 NOS/VE OPERATING SYSTEM BUILDS {CT} 

2020203 XLJ12F 


STMS$RING2_ PURGE_SET 
STMSRING2_ADD_MEMBER 
STMS$RINGZ2_REMOVE_MEMBER 
DMMSTEMPORARY.  NON_SET_CODE 
PFM$R2_REQUEST_PROCES SOR 
PFASCATALOG_SEGMENT_DEFINITION 


Z2e2e20e4 XLILZBE 


The packed object text file XLJ13F contains ail task. 
service modules which run in ring 3 task services. Modules 
from this file execute in ring 3 and have a ring bracket of 
(ls35F). 
The following modules reside in ring 3 task services? 


BAMSOPEN 

BUFFER_MANAGER 

HPP SHEAP_MANAGER 

BAMSRECORD_ MANAGER 
BAMS$BLOCK_MANAGER 
BAMSSEGMENT_PDINTER 

BAMSFILE_ STRUCTURE_FUNCTIONS 
BAMSFETCH_TABLE 

PMMSMANAGE_ CONDITION. STACKS 
PMMSPROGRAM_CONTROL_SERVICES 
TMMSDISPOSE_OF_RING3_PREEMPTS 
TMMSDISPOSE_PREEMPTIVE_COMMO 
TMMSMONITOR_ FAULT HANDLERS 
LOM$LOADER_EXECUTIVE 
LOM$LOAD_LLIBRARY_MODULES 
LOMSLIBRARY_LIST_ MANAGEMENT 
LOMS$LOGAD_MAP_GENERATION 
LOMSMODULE_LOADER 
LOMSENTRY_LEXTERNAL_MATCHING 
LOMSTEXT_GENERATION 
LOM$LINKAGE GENERATION 
LOMSLINKAGE_NAME_TREE_MGMT 
LOMSPROGRAM_SEGMENT_ MANAGEMENT 
LOMSDYNAMIC. TABLE_MANAGEMENT 
LOMSPROGRAM_LOAD_LIEUTENANTS 
PMMSKLUDGE_LOADER_IF 
DATA_PROFILE 

GET_DATA_PROFILE 
LOMSLOADER_STUBS 
LOM$TASK_SERVICES_ DEF MATCHING 
LOMSCROSS_REFERENCE_ MANAGEMENT 
CLMSMANAGE_STND_INP 
PMMSINTERFACE_TO_LOGGING 


os 28 OC 2H 2H 4H 
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RHMSINTERIM_SIMULATED_10 
RHM$S IMULATED_REPLACE 
RHMS$SIMULATED_GET 
LUMSMANAGE_LINK_USER_INTERFACE 
CLMSCGMMAND_ LIST MANAGER 
CLMS$REMOVE_VARIABLE 
CLMSWRITE VARIABLE 
PMMSDEBUG_STACK_MANAGERS_13F 
PMMSDEBUG_TABLE_BUILDER 
PMMSDEFAULT_UDADER_PARAM_ MGMT 
CLMS$BLOCK_STACK_MANAGER 
CLMSDECLARE_VARTIABLE 
CLMS$READ_VARTABLE 
CLMSINPUT_STACK_MANAGER 
DEBUG_LSYSTEM_LLEVEL_EXECUTION 
JMMSPROGRAM_LEVEL_LINTERFACES 
QUEUVE_FILE_PROGRAM_INTERFACES 
CLMSPROCESS_ASSIGNMENT 
PMMSMANAGE_LOCAL_ QUEUES 
AMMSSTORE_FAP_POINTER 

JMQF_ TEMPORARY _ MODULE 
BAMSCLOSE 

BAMSCONTROL 
BAMS$FETCH_ART_TABLE_POINTER 
BAM$PAD_RECORD 

BAMSREWIND 
BAMS$STORE_LART_TABLE_ POINTER 
RMMS$REQUEST_TERMINAL 
TIM$TASK_PRIVATE_DATA 
BAMSSEEK_DIRECT 

AMMS$STORE_ PROCEDURE_POINTER 
STMSCREATE_ SET 

STMSPURGE_SET 
STMSASSOCTATE_CATALOG 
STMSMISC_LSERVICE_ROUTINES 
STMSADD_MEMBER 

STM$C HANGE_ACCESS_TO_SET 
STMSS IMULATED_REST_OF_WORLD 
STMS$REMGVE_MEMBER 
DMMSMAKE_VOLUME 
PFMSPROGRAM_INTERFACE_ PROCESSOR 
PFMSPARAMETER_CHECKING 
PFMSPARAMETER_CONVERSION 


2ete2e Dd XLIIEE 


The packed object text file XLJILFF contains ati modules 
which run in the ring of the calier. Modules from this file 
have a ring bracket of (l»F»sF). 
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The following modules reside in the any ring task services? 


MCP ITP 

BDCALL 
SRMSCONVERSTION_SERVICE_MANAGER 
MISC_SERVICES_ANY_RING 
CMD_PROCESSOR_UTILITIES 
COMMAND_LINTERFACE 
FILE_MGR_COMMANDS 
DEBUG_USER_LEVEL_EXECUTION 
PMMSRUNANYWHERE_PRG_SERVICES 
MEMORY_MANAGER_REQUEST_PROCS 
CPMCB 
PFMSINTERIM_COMMAND_PROCESSOR 
AMMSFILE_STRUCTURE_FUNCTIONS 
PMMSCONDITION_STACK_PROCESSOR 
PMMSDISPOSE_GF_CONDITIONS 
PMMSDISPOSE_OF_TRAPS 
TMMSDISPOSE_OF_MONITOR_FAULT 
CLMSANALYZE_TOKEN 
CLMSANALYZE_VALUE 
CLMSSCAN_EXPRESSION 
CLMSCONVERT_INTEGER_TO_STRING 
CLMSLEXICAL_ PROCESSORS 
CLMSCONVERT_VALUE_TG_STRING 
OSMSFORMAT_MESSAGE 
OSMSSET_STATUS_ ABNORMAL 
DSMSTRANSLATION_TABLES 


OSAINX 
MMMSSEGMENT_FAULT_HANDLER 
CLMSACCEPT 
CLMSCOLLECT_TEXT_ COMMAND 
CLMSINCLUDE 


CLM$SPROCESS_COMMANDS 
CLMSSCAN_PARAMETER_LIST 
CLMSSET_OBJECT_LIST 
CLMSSET_PROGRAM_GPTIOGNS 
OSM$LOCK_ MANAGER 
MAINT_COMMANDS 
DSM$GENERATE_MESSAGE 
CLMSDISPLAY_VALUE_COMMAND 
CLMSACCESS BLOCK_STACK 
CLMSACCESS_ PARAMETERS 
CLMSFILE_ REFERENCE MANAGER 
CLMSCONVERT_STATUS 
PMMSDEBUG_S TACK MANAGERS_1FF 
PMMSPROGRAM_SERVICES 
PMMSSYSTEM_LTIME_DECLARATIONS 


oo“ 
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PMM$STATUS_QUEUES_DEFINED 
REC_MGR_ COMMANDS 
AMMSADVANCED_ACCESS_METHODS 
AMMSCLOSE 
AMMSFETCH_ACCESS_ INFORMATION 
AMMS$FETCH 

AMM$FLUSH 

AMMS$GET_NEXT 
AMMS$GET_SEGMENT_PDINTER 
AMMS$OPEN 

AMMSPUT_PARTIAL 
AMM$PUT_NEXT 

AMMSREWIND 

AMM$SKIP 
AMMSSET_SEGMENT_EOI 
AMM$STORE 
AMM$CHECK_RECORD 
AMMSDELETE_KEY 
AMM$GET_KEY 
AMM$GET_NEXT_KEY 
AMMSPUT_KEY 

AMMSPUTREP 
AMM$REPLACE_KEY 

AMMS$START 
AMM$SET_SEGMENT_POSITION 
AMM$GET_PARTIAL 
AMM$SEEK_DIRECT 
AMMS$GET_DIRECT 
AMM$PUT_DIRECT 
AMM$GET_PARTIAL_DIRECT 
AMMG$PUT_PARTIAL_DIRECT 
CLMSPERMANENT_FILE_COMMANDS 
CLM$DEBUG_COMMANDS 


2222226 Data Residency/Lifetime Based on Partition 


The Following rules appiy to static data defined by modutes 
in monitor or task services? 


1) Gntly moduftes within monitor may declare static data that is 
mainframe wired. 


2) Gnty modules within ring 1 task services may declare static 
data that is mainframe paged. 


3) Oniy modutes within ring 2 task services may declare static 
data that is in the job fixed segment. No modules may 
declare data in job pagable until the new system generator 
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is available. 


4) Only modules within ring 3 task services may deciare static 
data that is in the task private segment. 


5) Rules 1 through 5 also mean that all static data for a 
module in a given partition will reside as specified. 


6) Static data for modutes that run in the ring of the caller 
(XLJ1FF) must be read only when executing above ring 3+ 


20203 MANIPULATION OF NOS/VE PARTITIONS AND LIBRARIES 


When building a systems monitor must be linked first. All 
gated symbols within monitor then become availabte to task 
servicess which is tlinked second. Aithough some monitor 
symbols can be referenced by task servicess the onty way to 
execute monitor code is via the exchange jump —- i-2@s, the 
CALL/RETURN mechanism is not valid for use between monitor and 
job modes. User tasks are linked tast and can reference gated 
symbols defined in task servicese It is important to note 
that although the linker will allow a reference to ae given 
Symbols the ability to actually reference the tocation is 
determined by the ring brackets on both ends of the 
reference. 


20204 SYSTEM BUILD PROCEDURE DESCRIPTIONS 


In order to understand the procedure descriptions which 
follows, something should be said as to the sequence in which 
these procedures are used to generate systems. The following 
is an attempt to accomplish this: 


20204001 BACKGROUND INFORMATION 


Invoking the Procedures 


The procedures described below are documented as 
"SES «<Procedure_Name>",. In actuality» to invoke the 
procedures in this manner assumes that there is a file named 
*PROFILE* in the current catalog which names the Integration 
catalog to search for the procedure {via _ the *SEARCH? 


directive). The aiternative mechanism for invoking these 
procedures is to code the procedure call asi 
"SESs<Integration_Catalog>-<Procedure_Name>". Many of the 


procedures use the '"PRCUNAM!' vaiue for substitutabie user 
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namess meaning that the catalog in which the procedure is 
found is the catalog which is searched for Files. This is as 
it should bes since each of the Integration catalogs contains 
a different version of the systems 


All of the procedures described in this document have 
"HEL P” documentation associated with them. Use the 
SESs<Integration_Catalog>s»sHELP.~<Procedure_Name> call to have 
procedure documentation printed at your terminal. 


Current Packaging of NOS/VE_ Source 


There are two execution modes of NOS/VE which are referred 
to as the "standaione™ mode and the “duai-state"™ mode. Ali of 
the NOS/VE source modules which execute in the CY180 Virtua! 
State are contained on a program ltibrary named *NOSVEPL'. The 
program interfaces to the Virtuat State systems those 
described in the NOS/VE Program Interface ERS» exist as common 
decks on a program tibrary named tOSLPI*. The content of 
these two program libraries is referred to as the standaitone 
system. A deadstart tape can be produced of the standatone 
system for execution on the hardwares or the output of the 
Virtual Environment generator can be executed directty on the 
Hardware System Simulator. The I/0 support of this standaitone 
system when running on the simulator is defined in a separate 
set of common decks on a program tibrary named ‘'CYBICMN®,. 
Refer to the Simulated I70 ERS for documentation of these I/0 
interfaces. 

The dual—state execution of NOS/VEs in conjunction with the 
NOS operating systems requires NOS system modifications and 
the presence of a set of NOS utilities and procedure files. 
The software which supports this dual-state environment from 
the "NOS! side of the hardware is contained on ae program 
library named ‘f"VEL7OPL!'.} Inctuded in this package of NOS/VE 
support programs is a software application called the Interim 
Remote Host Facility which supplies job-to-job communication 
between the Virtual State and NOS portions of the CY180 
machine. The Interim Remote Host Facility build procedures 
are not documented here at this time.. 


2e2e4e002 THE BUILD SEQUENCE 
Update the Source Libraries 


The Integration project typicaliy updates the base source 
libraries prior to starting any recompilation or assembly of 
the system. In order for a user of these procedures to modify 
the source of a system routine he/she can use the SES 
"GETMODS*® procedure to extract the source being modifieds or 
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create the source in some other manner. If GETMODS was used 
to extract the sources then REPMODS can be used to put this 
changed source on a MADIFY program tlibrary in the user's 
cataloge Then. the filename containing this program tibrary 
must be specified as the value of the *AB* parameter of the 
NOSBILD procedure. (Refer to the Source Maintenance Section 
of the SES User'ts Handbook if you have questions about source 
maintenance. ) 


Compile/Assemble from Source 


Bne must first determine how much of the system is to be 
compiled or assembied. If onty a few modules (less than 5) 
are being compiteds then the NOSBILD procedure should be used 
with the  'M* option to update the appropriate Files. If a 
larger number of modules (5 or more in the same system 
jibrary) are to be recompileds then it is “cheaper” to use the 
*L*? > «©0option and rebuild the entire system library from 
scratche If more than two libraries are to be recompiled, 
then the NOSBILF procedure should be used to submit a separate 
execution of the NOSBILD procedure for each library to be 
rebuilt. This latter method is the one used for rebuilding 
all of the NOS/VE Virtual System from scratch. 

The general philosopy behind the NOSBILD procedure is to 
extract the flatest source of a module from a program tlibrarys 
compile or assemble the source to produce the appropriate 
object texts reptace/add the updated object text te the 
appropriate system Jibrarys and save this tibrary in the 
catalog in which the procedure is executed. The final result 
of the execution of the NOSBILD procedure should be an updated 
system library in the current user's catalog which is ready 
for the *LINKER® phase of the build. Jobs which run in “user 
mode", that is the interface to the system is gniy through use 
of the program interfaces (GSLPI)»s are saved merely as object 
text Files in the user's catalog and LINKER=-LOADER directive 
modifications are required to include these files as part of 
the system. This tatter capabitity will gradually be reptaced 
by the Virtual State LOADER and Library Generator features as 
they become available. 


Begin The LINKER-=LOADER phase 


The LINKER (SESeVELINK) and LOADER (SESeVEGEN) are packaged 
together in the Integration procedure NOSLINK.» This is for 
convenience purposess in that most LINKER changes to the 
system require a corresponding LOADER directive changes and 
the intermediate results from the LINKER execution are not the 
primary output used for system checkout. Prior to starting 
the LINKER-LGADER phase of system builds» some decisions need 
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to be made as to the target execution environment for the 
resultant output. 

If the target execution environment is standatone NOS/VE>» 
then the default NOSLINK options should be used to produce the 
file named *LGBOK*. This file can be run on the simulator 
using the NOSSIM procedures or can be used to create a 
deadstart tape using the **VSN*® parameter of the NOSSYS 
procedure. 

If the target execution environment is a duail=state 
environments then the OFFSET parameter must be used to specify 
how targe the NOS system will be. The systems produced for 
the Arden Hills 32 use GFFSET=256 to produce a LGB256K File. 
The LGB256K File is used by the NOSSYS procedure (when 
OFFSET=256 is specified) to produce a deadstart tape image on 
disk named *TP256K*, This deadstart tape image must then 
replace the file named TPXXXK»s which the duale-state deadstart 
procedure UPMYVE will then find. Refer to Appendix E— for 
Duait-State and standalone deadstart procedures. 


Generate the Deadstart File 


In order to generate a deadstart tape for standatone 
NOS/VEs it is onty necessary to run the NOSSYS procedure and 
specify the VSN of the tape to be written. Prior to 
generating a dual-state deadstart files however, it is 
necessary to verify that the utilities necessary to support 
the dual-state deadstart have been rebuiit via the DSBILD and 
BLDEI procedures. There are two portions of the duait-—state 
EI» the A170 portion is built using the BLDEI procedures and 
the C180 portion is rebuild using the NOSBILD procedure {deck 
named MLAEI). 


2e2e4%e1 NOSBILD Procedure Description 


The procedure NOSBILD is used to add or replace modules on 
a base object text file. NOSBILD retrieves the source module 
from a program librarys using the following search order: 


1) an alternate base optionally specified by the 
user (fooking first in the current catalogs and 
then in the <Integration>d catalog) 

2) OSLPI (from the <Integration> catalog) 

3) NOSVEPL (from the <Integration> catalog) 


This module is then compifed or assembled,» and the 
resulting object text is either added to or repiaced on a base 
file. A new version of the base file will be created in the 
current catalogs along with the direct access file NOSLIST 


Ce ed 
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which contains the compilation or assembly listing{s) of the 
module(s) compiled or assembted {one tisting per records 
headed by the matching MADIFY module names tisted via the 
LISTNVE procedure described in this document). If there are 
any compilation errorss the error tisting{s) will be put on 
the direct access file RPTERR2 (which has the same format as 
NOSLIST) in the current catalog. The indirect access file 
RPTERR1 will contain the message "COMPILATION ERROR IN DECK 
<module>." for each module which had compilation errors. Any 
GENCOMP errors will cause a similar message to be written to 
the indirect access file CMPERRI. 


If a specified moduie is to be replaced (i.e. it is 
already part of the existing system)» NOSBILD will by default 
use the same compilation options and will replace it on the 
same base object text file as when it was first added to the 
systems These options may be overridden by specifying the 
corresponding parameters described below. 


If a specified module is new to the systems the compilation 
and base object text file options may be directly specified 
using the parameters described below, If a list of new 
modules is specified» the compilation and base file options 
must also be specified as fists» and NOSBILD will match 
everything up  positionally. If these parameters are pot 
specifieds and NOSBILD is executing in LOCAL modes ai warning 
message will be issued telling the user that the module is not 
in the current system. The user will then be prompted for the 
necessary information. If these parameters are not specified 
and NOSBILD is executing in BATCH modes the compitation and 
base file options default as specified betow. 


If the "4" parameter is specified » each module's object 
text will be copied to a temporary "2! file. The old tibrary 
file will then be purgeds and the '2z* file will be renamed as 
the new Jlibrary file. All compilation tfistings will be 
LIBEDIT*ed onto NOSLIST from a temporary tisting file at the 
end of the procedure. 


When an entire tibrary is being rebuilt via the 1? 
parameters the module names and their corresponding 
compilation options are obtained from a file which contains 
ald this information for each tibrary. NOSBILD searches for 
this file first in the current catalogs» and then in the 
<Integration> cataiog. The name of this file must be the name 
of the library minus its first character {eege 'LJ13F* for 
the tibrary "XLJ13F")» and the first line of this file must be 
the file names To make additional entries or change existing 
entries in this file» the following procedure should be 
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folloned: 


1) EXTRACTs<libdeks>/UN=<Integration>. 

(where <libdeks> is the name of the compilation. 
information fiie for the tibrary as described 
aboves and <Integration> is the Integration 
catalog) 

2) Edit <libdeks> to add or change entries. The 
format and spacing of each entry is important and 
must be as Follows: 

(<m>9<eo>e<xrefoas<iL>)- 


where 

m = a 7~character tleft-justified module 
name 

c > a l—-character compilation option 
C9O%, t2 42,5924, 43%, or 74°93 See description 
of *ct parameter below) 

xref = a 3-character feft—justified cross 
reference option (either "YES? or "NB #) 

11 = @ 7~-character feft-justified 


destination library name. 
the entries currentiy in these files ali follow 
this format so that any additional entries may be 
lined up quite easily with them. 
3) SAVEs<libdeks>. 


NOSBILD (with the "{* parameter specified) may then be used to 
rebuild the library using these new/modified compitation 
options. 


The format of the NOSBILD is as follows: 
SESe-NOSBILD C m={<module name>d..<module named) j 
{ §2< fibrary name > Jj 
{C cx(<compilation optiond.~.<compilation option>) ] 
{ xref=(< xref optiond.e<xref option>d) J] 
{[ 11 = (<base file>.~..<base file>) ] 
{ ab = alternate base> ] 
{ omit = (<module namedee<modute name>) j 
C tink } tink = <offset valued Jj 
C test = <test file name> Jj 
{C print J 
{ batch ] 


m 3 The module names or range of modules»s or iist of 
module namese 


{ 3: The library name. Onty one library at a time may 


ae 
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be selected. To select more than ones use the 
NOSBILF procedure. 


c % c = 0 to assemble a module 
¢ = 1 to compile a CYBIL module (DEFAULT) 
c = 2 to compile a CYBIL module without range 
checking > s 
c = 3 to compile a CYBIL modute using CYBICMN type 
declarations 
c = 4 to compite a CYBIL module using CYBICMN type 
dectarationss and with range checking turned off 


se 


*YES?' to run across reference (CYBREF) 
'ND® to not run a cross reference (DEFAULT) 


xref 


11 3 The base file (list of base files) onto which the 
module (list of modutes) is to be added or 
replaced. If anew modules the defauit is 
'XLJIFFSE. 


ab 3 The user's aiternate base program library 
containing new and modified modules. The defauit 
is "NEWDKPL?#. 


ae 


omit Used when running a full builds a module name or 
list of module names to omit from the build. The 


default is none. 


link 


Option to fink the newly built or modified system 
using the procedure NOSLINK. Specifying simply 
the keyword *LINK® or "LINK = OF links a NOS/#/VE 
stand-alone system. To link a dual. state systems 
specify "LINK = <offset>'* where <offset> may be 
given the values 2565 1289 or 64. The default is 
to not tink the system. 


ee 


test The name of the file containing the NOS/VE test 
commands to be input to the simulators which will 
be executed after the system has been linked 
{using © procedure NOSSIM). This parameter is 
invalid if the tLINK!® option has not also been 
specified. The default is to not run the 
simulator test. 


print 3: Dption to print the link map following the linking 
of the system. The default is not to print the 
link map. 
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oe 


batch Run NOSBILD in BATCH mode.w The default is to run 


it locally. 
NOTE. : Dne of 'm* or *1* parameters must be specified. 
2e2e4e2 NOSBILE Procedure Description 
NOSBILF is an SES procedure file which submits one batch 
procedure execution of NOSBILD for each system tibrarys each 
with the 'J'! parameter specified for the library to be built. 


The format of the NOSBILF is as follows: 


SESe-NOSBILF € 1 = <fibrary name dj 


{C batch J] 

1 3 The t1* parameter specifies the tibrary to be 
built. It can be one fibrary or a tist of 
libraries. The default is to rebuild the entire 
system. 

batch 3? Run NOSBILF in BATCH modee The default is to 


run it tocatly. 


Note : To rebuild one tibrarys, the following are 
identical: 
1) SESe~NOSBILF =< library name > 
2) SES-NOSBILD Je#< library name > batch 


202043 LISINVE Procedure Description 


LISTNVE is an SES procedure file which extracts the 
compilation listings of the modules specified by the ‘'M# 
parameter (module names correspond to the MADIFY deck name 
given the module) from a text library file and writes them to 
the file specified by the '"F*® parameter in a printable 
format. The 'M! parameter may select a singie modules a tist 
of modufless and/or a range of modules on the tibrary file. 


The tibrary file which contains the tistings may be 
selected via the tI* parameters, and defaults to NOSLIST. 
LISTNVE will search for this file in the current catalog 
firsts and if it is not there it wit! go to the catalog 
specified by the *"UN* parameter. 


When LISTNVE has completeds the output file selected by the 
'O' parameter will be a Jocal file. It is not automatically 
printed unless either the '"PRINT® or "BATCH! option iis 
selected. 
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The format of the LISTNVE is as foltows: 


m= { module name>e»<module name> ) Jj 
i= <file named ]j 

0 = <print file name> 1]. 

un = <user name> j 

print ] 

batch ] 


SES»LISTNVE 


at or 


m 3 The module name{s) and / or range of modute 
names which are to be extracted “for 
printing. The default is to extract and 
format ail of the modules. 


i? f 3 from : The name of the text tlibrary file from 
which the compilation listings are to be 
extracted. The default is NOSLIST. 


0 i to ! upon : The name of the file which will receive the 
formatted listings to be printed. The 
default is LISTING. 


un 3 The name of the catalog to search for the 
library file should it not be found in the 
current catalog. The default is the 


<Integration> catalog. 


print 3 Option to print the listing file after it 
is formatted. The defauit is to not print 
the fisting file. 


batch : Run LISTNVE in BATCH modew The default is 
to run it tocaily. 


20225 NOSLINK PROCEDURE DESCRIPTION 


NOSLINK is an SES command fanguage procedure file which 
wili call both the VE Linker and VE Generator (using the 
standard SES procedures VELINK and VEGEN) to produce a 
checkpoint file and tink map file. In order to do this it 
will link monitor and task service routines from their object 
text files. It will search ali files that it requires 1) from 
focal files 2) from the current catalogs 3) from area user's 
catalog (if the area parameter is specified)» 4) from the 
<Integration> catalog. 


NOSLINK will fink either a stand-alone or a dual state 
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system. The choice is made via the OFFSET parameter {see 
description below). NOSLINK wil! put the checkpoint fille on 
the direct access file LGB<offset>K»s and the fink map will be 
placed on the direct access file MAP<offset>Ks where the value 
given the OFFSET parameter is substituted into each name “for 
<offset>d. 


To link additional user jobs into the systems create a file 
in the current catalog containing the commands needed to 
obtain all the necessary files as well as a cali to VELINK for 


each user job to be linked. Specify this fite via the ADD. 


parameter» and NOSLINK will pick it up and physically insert 
it into procedure command stream immediately following the 
fast call to VELINK. [he first line in this. file MUST be the 
file_nameil_ 

The Format of the NOSLINK is as follows: 

SESsNOSLINK C€ offset = < load offset > J] 
{ save ] 
{C quick ] 
C uj = ( ¢€ user job DseeeeK user job > ) ] 
{ add = < additional finks file > Jj 
{ print ] 
{[ test = < test File name > ] 
Ct dump ] 
{ area = < user name > j 
{C batch ] 


offset : The load offsets» used to determine whether to 
link a stand-alone or a dual state system. 
OFFSET = O links a stand-alone system (DEFAULT) 
OFFEST = 256 links a dual state system (to use 
on the $2) 
OFFSET = 128 links a 128K dual state system 
DFFSET = 64 tinks a 64K dual state system 


save 3 Option to save the monitor and task services 
segment files created during the tink for 
Subsequent “quick tink" use by this procedure. 
The default is not to save these segment files. 


quick 2 Option to do a “quick link™. <A more complete 
description of this option can be found in the 
section entitied “Quick Link Option of NOSLINK 
Procedure”. The default is not to do a éaquick 
link. 


uj 3 File or fist of files containing the existing 
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user job binaries that are to be linked into the 
systems The default is to tink in gill existing 
user jobs. 


add : The name of the fite containing the commands 
needed to tink additional user jobs into the 
system. The default is to not tink fin any 
additional user jobs. 


print 3 Option to print the tink map. The defauit is 
not to print the link map. 


test 3: The name of the file containing the NOS/VE test 
commands to be input to the simulators which 
will be executed after the system has been 
linked fusing procedure NOSSIM). The default is 
to not run the simulator test. 


dump 3 Option to print a memory dump of the system. 
Default is no memory dump. 


area ? Option to obtain the object files or tinker 
parameter files from another user's catalog 
{other than the current catalog in which the 
procedure is executing). The default is for no 
area user cataiog to be searched. 


batch 3 Run NOSLINK in BATCH mode» The default is to 
run it locally. 


2.20501 LPE File Description 


The LINK commands used in the NOSLINK procedure do not 
specify enough information to totally define the requirements 
of the ftinking operation. Many additional parameters are 
suppiied to the linker through additional data files. This 
includes information such as? 


- Ring Numbers 

—- Segment Numbers 

~ Segment Attributes 
- Execution Privitege 


Currentiy this information is supplied to the linker via 
the SES Linker Parameter File (LPF) file. The linkage between 
the tinker and the LPF file is activated by the LPF#LIBLCB 
parameter on the LINK commands. For the monitor fiinkage this 
information is on LPF file MTRLCBs task services tinkage 
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information is on LPF fite STSLCBs and EL/EI€E linkage 
information is on EILCB/EIELCB respectively. 


2e2e5e2 VELDOCM 7 LDR File Description 


The VELDCM file used by the procedure NOSLINK contains 
directives to the CPF Generator which allow it to produce a 
checkpoint file from the segment files produced by the VE 
Linker. These directives set up the physical environment into 
which NOS/VE is placed» and include such things as the 
definition of the page sizes job and monitor exchange package 
addresses» page table address and tengths preallocated segment 
array definitionss etc. 


VELDCM is a "skeleton" file which is dynamically edited 
during the execution of the NOSLINK procedures depending upon 
the specification of the OFFSET parameters The edited file is 
then put on a direct access file named LOR<offset>K (where 
<offset> is replaced by the value given to GFFSET when the 
procedure was called) in the user's catalog. It contains the 
directives to the CPF Generator which set up the physical 
environment for that particular iink. This file must remain 
permanent in the user®?s catalog after NOSLINK has. been 
executeds as the procedure NOSSYS uses this file in building a 
deadstart tape. 


203 ADDING USER TASKS TO _NOS/VE 


20301 INTRODUCTION 


A user task can be defined as a group of modutes§ tinked 
together that will execute in the ‘user ring!’ of NOS/VE»s 
currently ring 11. This task may make calis to any gated 
entries within task services (rings 1 through 3) if the call 
bracket will allow the cali. Data defined within task 
services may not be referenced from rings 4-15. 


20302 QUICK LINK OPTION OF NOSLINK PROCEDURE 


To doa “quick dink", specify the QUICK option on the call 
to NOSLINK (see the section entitied “"“"NOSLINK Procedure 
Description ). In this case NOSLINK does not fink monitor and 
task services from their object text files each time. 
Instead» it uses already. dinked monitor and task service 
environments, and just finks the specified user object files. 
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The QUICK. option causes NOSLINK. to run faster and requires 
less resources than the full tinks and therefore should be 
used instead of the full link when only user_tasks are being 
added to NOS/VE. 


NOSLINKs with the QUICK option specifieds should not 
require any modification to execute in different user task 
configurations. The user can merely name the user object text 
file produced by an assembly or compitation as *XUUSER1I!'. To 
link additional user object files into the systems either 
specify the existing files to be tinked via the UJ parameter» 
or specify the necessary command file via the ADD parameter. 
The contents of this files its uses and the function of the UJ 
and ADD parameters are described in greater detail in the 
section entit!ed "NOSLINK Procedure Description". 


20% NOS/VE SIMULATION 


2e4e1 RUNNING A SIMULATOR TEST (NOQSSIM PROCEDURE) 


NOSSIM is an SES procedure file which will run either a 
batch mode or an interactive simufation of NGS/VE. This 
option is selected via the #TEST* parameter. If "TEST is not 
specifieds, then the simulation will be run interactively. If 
a batch mode simulation is desireds then 'TEST!' is used to 
specify the name of the file containing the NOS/VE test 
commands that are to be input to the simulator. The BATCH 
keyword must also then be specified. If the user wants to use 
his/her own simulator directives files the "CMDS* parameter 
must be specified. 


NOSSIM also aliows the selection of the checkpoint file to 
be used for the start of simutation. <A checkpoint file may 
also be optionally saved at the end of the test. The C€180 
memory size may be changed via the "MEM? parameter. 


The NOSSIM procedure will create several permanent files in 
the user's catalog if not run interactively. These are 
itemized as follows: 


1) JOUTIPUT.»~ This direct access file contains ali of the 
output of the NOSSIM procedures including 
- a copy of the command file used as input to the 
Simulator ("TEST*® parameter) 
-~ the output produced by the system 
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~ the SESLOG File 

~- areformatted keypoint listing 

—~ DEBUG output (Cif FSIMDBG* was specified on the 
NOSSIM call) 

- asummary of all (paging) disk 1470 (HIOLOG file) 

- the toad map produced by the CITDIE conversion and 
execution of XUUTL (SIMLGAD file) 

- optionally) a hex dump of the checkpoint file at 
the end of simulation 

- the job dayfile. 

This file is automatically sent to the line printer. 


ah Oe Oe 


2) SESSMKE-~ This direct access file contains the keypoint 
data produced by the simulator. It is reformatted by 
the procedure NOSKEY before being written to the File 
TOUTPUT. 


3) JDAYE. The dayfile of the NOSSIM job will be written 
to this direct access file should it terminate 
abnormally. 


Additionailys if the  "#NCPF® parameter is specifieds NOSSIM 
will create 4 direct access files which together contain the 
NOS/VE environment at the end of simulation. The file 
specified by the *NCPF* parameter will contain the current 
NOS/VE checkpoint file. The other 3 files (formed by adding 
the characters O» ls and 2 to the "*NCPF® file name —- which 
must therefore be six or tess characters tong) are used for 
NOS/VE memory paginge 


The format of the NOSSIM is as follows: 


oe 


SES-NOSSIM C test = < command file > Jj 
{[ cpf = < checkpoint file > ] 
C nepf = < new checkpoint file > J 
C mem = < memory size in hex > ] 
{ cmds = <€ simulator directives file > ] 
{ nods ] 
{ simdbg J] 
{[ dump } 
{C batch ] 
test : The File containing the NOS/VE test commands. 
The default is to run interactively. 
cpf 3 The checkpoint file used for the start of 


Simulation. The default is "LGBOK*". 


nepf 3 The checkpoint file to be saved at the end ~of 
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simulation. The default is not to save a 
checkpoint file. 


mem 3 The €180 machine memory sizes in hexs needed to 
run the simulation. The default is 
*"100000(16)". 

emds 3 Simulator directives file which should be 


supplied by the user. The default is to use the 
one created by the NOSSIM procedure. 


oe 


Option to use the version of the checkpoint file 
from the <Integration> catalog which has already 
been deadstarted. The default is to use a 
checkpoint file which has not been deadstarted. 


nods 


simdbg 


oe 


Option to turn DEBUG on for the. current 
simulator rune. The defauit is to run with DEBUG 
off. , 


dump 3 Option to inctude the dump of the checkpoint 
fiie at the end of simulation as part of the 
NGOSSIM output. The default is not to dump the 
checkpoint File. 
batch 3 Run NOSSIM in batch modee The default is to run 
it locally. 
20422 NOSKEY PROCEDURE DESCRIPTION 
NOSKEY is an SES procedure file which creates a simutator 
generated keypoint trace file. The output of this procedure 
is the local file *KEYFILE*. 
The format of the NOSKEY is as follows: 
SES»zNOSKEY C kpf = < keypoint file > ] 
kpf : The keypoint file generated by the simulator 
which is used as input to XXMYKEY.j The default 
is ®*SESSMKF*,. 
20423 DUMPING A SIMULATOR CHECKPOINT FILE (NOSDUMP PROCEDURE) 


NOSDUMP is an SES procedure file which makes a DSDI dump of 
a simulator checkpoint file. 


ae on oe 
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The format of the NOGSDUMP is as follows: 


SES.NOSDOUMP [ cpf = < checkpoint File > ] 

f 1 = < output file > ] 
{C dump = STND $ ALL 1 
{ print J] 

{ batch J 

cpf 3 The checkpoint file which is to be dumped. The 
default is “"CKPT*®, 

!o: The file which is to receive the dump output. 
This file will be a focat file after the 
procedure has finished executions It is ynot 
automatically printed. The default is 
"DSDIOUT". 

dump 3 Option to either dump the environment according 
to ASID (DUMP=STND) or dump the entire 
environment (DUMP=ALL). If "DUMP=STND* is 
chosens then the DOSDI directives are taken from 
the file DSDIXs which the procedure will search 
for first in the current catalog and then in the 
<Integration> catalog. The default is 
"DUMP2STND*®. 

print ? Option to print the DSDI dump output. The 
default is not to print the dump. 

batch : Run NOSDUMP in BATCH mode. The default is to 


run it locally. 


205 BUILDING A_DEADSTART FILE 
20521 INTRODUCTION 


205022 CREATING THE FILE (NOSSYS PROCEDURE) 


The SES procedure NOSSYS builds a deadstart file from the 
checkpoint file created by the linking of the system. The 
"OFFSET* parameter allows the option of building either a 
stand-alone or a dual state deadstart file. If the parameter 
"YSN! is specifieds, then the deadstart file will be written to 
tape; otherwise it is written to the file TP<offset>K where 
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the value of the fOFFSET*' parameter is substituted for 
<offset> in the name of the file. 


NOSSYS requires additional object files for inclusion on 
the deadstart file. These object files contain PP object code 
for the following functions: 


1) Deadstart (file XIDST) 

2) 844 driver (file XIDSK) 

3) Console/Printer drivers (file XIDSP) 
4) PP helper (file XTIHLP) 

5) PP Resident program (file XIRES) 

6) Others to be defined tater 


If these Files are not present in the current user catalogs 
they will be obtained from the appropriate catalog. (ie. 
SESsINT2. prefixed procedure caltis access INT2 tevel system 
files ontlys white SES»sINT1. prefixed procedure calls may 
access files from either INT2 or INT1 catalogs as is 
appropriate for the system being built.) 


A copy of the tinkmap file (lanker/toader output) will also 
be inciuded on the stand-alone deadstart file. A copy of the 
loader directives will be inctuded on the dual state deadstart 
file. These are the files MAP<offset>K and LODR<offsetdk 
{descriptions of these files are included in previous 
sections)» and must be in the same catalog as the file 
specified by the 'CPF* parameter. 


The format of the NOSSYS is as follows: 


SESe-NOSSYS € vsn = < tape vsn D 1] 
{ offset = < load offset > J] 
{ cpf = < checkpoint file > j 
{ cyblink J 
{ batch ] 

vsn ? The VSN. of the tape to be written. This file 
must be available to the operator. The default 
is to write the file to a tape as specified 
above, 

offset : The load offsets used to determine whether to 
bulftd a stand-alone or a dual state deadstart 
file. 
OFFSET = 0 builds a stand-atone deadstart fite 
(DEFAULT) 


OFFSET = 256 builds a duai state deadstart file 
{to use on the $2) 
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OFFSET = 128 buitds a dual state deadstart file 


for a 128K system 


OFFSET = 64 builds a dual state deadstart file 


for a 64K system 


cpf 3 The checkpoint file used in creating 
deadstart file. If the File does not exist 


the 


in 


the current catalogs it wil! be obtained from 


the <Integration> catalog. The default 
LGBOK. 


cyblink 3 Option to create a tape for CYBERLINKING 


is 


to 


CANCCD. The default is to build a hardware 


deadstart file. 


batch ? Run NOSSYS in BATCH modes The defau!t is to run 


it locally. 


22523 COMPILING 180 PP CODE (CPP180 PROCEDURE) 


CPP180 is an SES procedure file which compiles 180 
code. The source for the PP code may be retrieved from 


pp 
a 


source file (*SF" parameter) or a program tibrary ¢*M*" 
parameter). If the "AB" parameter is specifieds CPP180 will 
search this PL first before searching NOSVEPL to satisfy 
externals. The "UN™ parameter specifies the catalog in which 


"AB" resides. NOSVEPL comes from the <Integratlon> catalog. 


The format of the CPP180 is as follows? 
SES.~CPP180 C€ m = € module name > Jj 

{ sf = <€ source file name > Jj 
{ ab = <¢ atternate base > ] 

C un = € user name > Jj 

{C print J 

{ batch ] 


m 3 The module name of the PP program to 


be 


compiled. If "™M™ is not specified then ™SF*® 


must be specified. 


sf : The source file residing in the current catalog 


which contains the 180 PP source code for the 
program to be compilede If "SF" is 
specified then "M" must be specified. 


PP 


not 


ab ? The alternate base searched by CPP180 to satisfy 
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externals before searching NOSVEPL. The defautt 
is to search onty NOSVEPL. 


un 3 The user name of the catalog containing the 
aiternate base specified by the "AB*" parameter. 
The default is the current catalog. 


print 3 Option to print the assembly  tistings The 
default is to not print the listing. 


batch ; Run CPP180 in BATCH modew The default is to run 
it locally. | 


206 DUAL STATE PROCEOURES 


22601 BLDET PROCEDURE DESCRIPTION 


BLOEI is an SES procedure file which buiids the absotute 
file for dual state EI. The I parameter may be specified if a 
file containing the dual state EI source exists in the current 
catalog; otherwise BLDEI retrieves EI from NOSVEPL in the 
<Integration> catalogs 


BLOEI uses the finker parameter file EILCB to link EI. If 
this file does not exist in the current catalogs it is 
obtained from the <Integration> catalog by the procedure. 


The outputs of BLDEI include the direct access absotute 
file 'E€I* and the direct access file "'EILIST!® which contains 
the assembly listing and the link map for EI. 


The format of the BLDEI is as follows? 

SES~BLDETI {C § = < EI source file > J 

i: The file in the current catalog which contains 
the dual state EI source From which EI is to be 
built. The default is to get the EI source from 
NOSVEPL in the <Integration> catalog. 

2e6e2 CPUMBLD PROCEDURE DESCRIPTION 
CPUMBLD is an SES procedure file which builds the dual 


state binaries for CPUMTR»s which will be put on the direct 
access file XCPUMTR. The "I* parameter may be specified if 
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the compile file for CPUMTR exists in the current catalog; 
otherwise CPUMBLD retrieves CPUMTR from VE1L7OPL» searching 
first in the current catatog and then in the <CIntegration>d 
catalog. The assembly tisting will be written to the direct. 
access text library file DSLISTs with the heading CPUMTR. 


The format of the CPUMBLD is as follows: 


SES-CPUMBLD C€ i = < CPUMTR compile file > ] 
{C batch ] 


24 The file in the current catalog which contains 
the duai state CPUMTR compiie file from which 
the CPUMTR binaries are to be built.. The 
default is to get CPUMTR from VEL7OPL in the 
<Integration> catalog. 


batch : Run CPUMBLD in BATCH mode. The defauit is to 
run it tocally. 


206.23 CTSBILD PROCEDURE DESCRIPTION 


CTSBILD is an SES procedure file which buitds the dual 
state binaries for CTS and MXS and puts them oan the direct 
access file xXCTS.~ The assembly listings for CTS and MXS are 
written as one record to the direct access text iibrary file 
DSLISTs with the heading "CTS". 


The format of the CTSBILD is as follows: 

SES~CTSBILD € batch ) 

batch : Run cCTS8ILD in BATCH mode. The defauit is to 

run it focally. 

22624 DSBILD PROCEDURE DESCRIPTION 

DSBILD is an SES procedure file which buiftds the dual state 
binaries XDSTVE» XRUNVE»s and XTRMVE. All assembly and I[SWL 
compilation listings are put on the direct access text library 
file OSLIST {one tJisting per records each headed by the 
corresponding MADIFY deckname) and the three foad maps are 
saved on the direct access fite DSMAP, 


The format of the DSBILD is as follows: 


SES-DSBILD C batch J] 


| 2-30 
ADVANCED SYSTEMS INTEGRATION PROCEDURES NOTEBOOK 

_ | | _ | _ 09417180 
2.0 NOS/VE OPERATING SYSTEM BUILDS (CI) 
20624 DSBILD PROCEDURE DESCRIPTION 


batch : Run DSBILD in BATCH modee The default is to run 
it focally. 


206.5 PPBILD PROCEDURE DESCRIPTION 


PPBILD is an SES procedure file which builds the dual state 
PP binaries for MMCPP and PPHELPs which will be put on the 
direct access files XMMCPP and XPPHELP respectively. Both 
assembly tistings are put on the direct access text library 
file DSLIST (one tisting per records each headed by the 
corresponding MADIFY deck name). 


The format of the PPBILD is as follows? 
SES»PPBILD [ batch ] 


batch : Run PPBILD in BATCH mode. The defauit is to run 
it locally. 
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320 DUAL STATE INSTALLATION SEQUENCE 


This section describes how to install all of the files 
needed to run NOS#VE in Duai State mode. To do this from 
"scratch" the following materiats are necessary? 


CMSE.tape 

CTI tape 

EI tape 

Dual State NOS Deadstart tape 

The LOADPF tape(s) which contain the NOS/VE environment 


Oe el oe 


If CMSE» CTI» and EI are already present and corrects then 
it is only necessary to install a new deadstart sector on disk 
or to toad a new NOS/VE environment. If A170 NOS has been run 
on this machine prior to the instafilation of NOS/VEs then 
chances are excellent that the proper versions of CMSE and CTI 
were useds There are incompatibitities between the A170 
EI/NOS system and the Dual State environment which prectude 
the usage of these same materials» however. 


3el CLEAR POINTERS AND INSTALL CTT 


To clear the pointerss deadstart from the CTI tape which is 
MT» D=800» FSI» LB=*KU,s and enter: 


*U#——-—>R (Release) 
Channel =xx 

Eq=xx 

Unit=xx 


Deadstart again and then enter: 


*U*--——>I (Install D/S module on disk) 
Channel=xx 

Eq=xx 

Unit=xx 
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342 INSTALL CMSE 


To instati CMSE,» deadstart from the CMSE tape which is MT» 
D=800» FSI» and then enter: 


ODT=2 
CHANNEL=xx (CMSE tape) 
TD X 
*C! option (Build directory in CM and copy to disk) 
Device type=x 
Channelz=xx 
Eq=xx 
Unit=xx 
MT typex3 
MT channel=xx 
Eq=zxx 
Unit=xx 
User type=02 (Shared 0/5) 
Instaii options=02 
Options=01 (Build without D/7S sector since it was 
already created by CTI.) 


303 DELETE OLD_EI 


To delete the oid Error Interface (EI) files deadstart from 
the unit where CMSE is instaltleds then enter: 


Mx 


Then to display the tist of binary files and check if EI is 
theres enter: 


AF. 
*DP EI (will delete EI if it is there) 


opt: *WK INSTRO 0 COO (to write microcode from P2 to CMSE 
disk — takes a tong time) 


304 INSTALL EL 


To instaif EI mount the EI tape which Is MT» D#800s FSI» 
LB=KUs and deadstart from the unit where CMSE is instaitted. 
Then enter? 

*M* 
TOX 


oe ee 
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{CR} (A directory for CMSE already exists» so this 
will update the directory.) ; 

Disk Type=xx 

Channel=xx 

Eqzxx 

Device Type=(EI tape) 

MT type=xx 

Channel=xx 
. Eq=xx 

Unit=xx 

User type=02 

User Options=02 

Bptions=02 (Add a new program) 


When END appearsys EI is instatied. 


305 INSTALL SYSTEM 


Deadstart from the NOS Dual State deadstart tapes using the 
deadstart tape which is to be installed. Choose the ‘*Q# 
option on the first displays for operator interventions, Then 
choose the *H!' option on the next display to see the hardware 
parameters. Enter C€M=10000. Optionailys the *P* display may 
be selected to choose a CMRDECK. {(CMRDC14 contains the CANCDD 
$2 configurations CMROCKE contains the ARHOPS $2 
configuration.) After the system is deadstarteds», enter the 
Foliowing commands: 


X.DIS. 
COMMON »sSYSTEM. 
INSTALLas SYSTEMsEQxx, 


NOTE: xx is the EST ordinal of the disk where the deadstart 
sector is to be installed; this is the same disk where CMSE 
was installed previously. 


306 LOADPF_FILES 


The LOADPF tapes» which are NTs D*PE»s F2SI»s and LB=KL» 
contain the NOS/VE operating system source and binariess toots 
to assemble and tink the operating systems and various other 
files. Included in these files is the ODSINSTF file which 
contains the Dual State execution environmente 

Deadstart from the disk upon which the NGS Dual State 
system was installeds LOADPF the files to the desired user 
numbers and instali the Dual State execution environment in 
the following manner? 
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ATTACHsDSINSTF. . 
BEGIN» DSINSTFsDSINSTsSCAT=catsINST=FULL. 


where: cat is the user number of the catalog in which the 
execution environment is being instalied. (In ARHOPS this is 
the DEV1 catalog.) . 
Check the indirect access file CMDS1 to make sure it 
reflects the hardware configuration? . 


*RELOADCH=x. x should be an empty channel. 
*DISKCH=y. NOS cannot use channel y with Dual State active.. 
*SYST»DISKUZ=ON. 2 can only be 0 through 3. 
{Unit z on channel y cannot appear 
in the NOS CMRDECK or EST.) 


307 BRING UP_ DUAL STATE 


After the NOS Dual State system has been deadstarteds and 
the Dual State execution environment has been instatiteds 
NOS/VE is brought up by entering the following console 


command: 
X»UPMYVE{CAT=c) 
where? c is the user number in which the execution 
environment was installed. Enter Kon. (n = the control 


point number of the UPMYVE job) to see the NOS/VE display. 
Ke*BYEVE. will terminate NOS/VE. For further information 
regarding the operation and execution of this environment 
refer to the S$2 Machine Usage Documents 


oe 
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400 NOS/VE HARDWARE REGRESSION TESTING 


%e1 INTRODUCTION 


The verification currently performed on NOQS/VE systems 

consists of the following: 

1) running the simulator test input contained on file 
VQLTST3 until visual examination of the output from this 
test warrants that further testing should be performeds 
and 

2) running the S2 Regression Test Sequences as outiined in 
the following sectionss on the hardware. 


402 32_ REGRESSION TESTS 


4e2e1 REGTEST 


REGTEST is a file containing a sequence of HCS commands. 
It runs a series of user test programs on the hardwares and 
puts quite a heavy toad on the systems REGTEST takes 
approximately 20 minutes to rune The command sequence 
follows: 


€X UUTL *BULK,2* 

PFSTATS 

EX UUTL ¥*CALLERsUUTL 910 s**TESTMEMs 1LO000000##* 
EX SDRT *20009100* 

EX UUTL *CALLER »SORTs59*1000» 50% ** 

EX UUTL *TESTMOVE»1000000* 

EX UUTL *A170510* 

EX UUTL *LOOP »30000*% 

TMTERM YUTL 

EX UUTL *CALLER»s UUTLs 10 s¥*¥*CYCLEs 30000 *#* 
TMTERM UUTL 

EX UUTL *CALLERsUUTL » 59 **L OOP 91 800*#* 

EX UUTL *CALLER sUUTL» 59 **TIMEQUT s100918004** 
/SSET QUANTUM 5000 

7SSET PITVAL 1000 

EX UUTL CALLER s UUTL 95» *#BULKNTC 5 2%*% 
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EX UUTL FCALLER »SGRT 55 59**1000550*%* 
EX UUTL *TESTMDVEs1000000* 

TSTATUS 

JMEXIT 


40222 TESTBAM 


TESTBAM is a file containing the statements necessary to. 
execute ail of the BAM test cases supplied by We Ve Mahal. 
These procedures exercise various portions of the basic access 
methods, and are used to show some tevel of confidence that BAM 
works as welt as it has previousty. The command sequence 
follows: 


EX BAMTEST 
TES1 
TES2 
TES3 
TES4 
TES5 
TES6 
TES7 
TESB 
TES9 
TES10 
TES11 
TES13 
TES14 
TES15 
TES16 
TES20 
BAMSTOP 
JMEXIT 


40223 JOB1 


JOB1l is a file containing the NOS/VE commands which stage a 

CI object file from the 170 side to the 180 sides convert this 
file to an II library files and replace the II library on the 
170 side.e. It tests the following NOS/VE features: 

LINK_USER command 

GETPF B60 

CITOII conversion 

BDbject Library Generator 

Display Library Information 

REPLACE B56 


aoe ee eT | 


on £6 we SE Of 4H 


oe 20 £2 0 BO OH 6H BH CH 46 BH 4H GO OH HO HE GE OO HH 


Se 6 be CO 64 26 Oe 24 we HO 


4-3 
ADVANCED SYSTEMS INTEGRATION PROCEDURES NOTEBOOK 

ae 7 | 09/17/80 
420 NOS/VE HARDWARE REGRESSION TESTING 
4023 JOB 


JMEXIT 


The command sequence follows: 


EX ZDISsasA 

SCL 
LIUsUSER*(INT1l»NVE) »PA=INT1X» A=NOTUSEDs PR=NOTUSED 
HCS 

GETsCITEXT1 80 sCYBILGOs» »sNVEsB60 

EX CITOII #CITEXT1LSOs II TEXT180* 

EX COL 

ADD »sQF2IITEXT180 

DILIBsON=A 

GENsLIBRARY=LIBRARY180 

END 
REPLACEsLIBRARYLSOsCYBIILB ss sNVE»B56 
JMEXIT 


40204 JOB2 


JGB2 is a file containing the NOS/VE commands which stage 
an II tibrary and a Cl user job object file from the 170 side 
to the 180 sides convert the CI user job object file to an II 
object files and then load and execute this user job with the 
library. It then stages the LOADMAP back to the 170 side to 
be printed. J0OB2 tests the following NOS/VE features? 

LINK_USER command 
SET_QBJECT_LIBRARY (SOL) command 
SET_PROGRAM_OPTIGNS (SPO) command 
GETPF B56 

GETPF B60 

CITOLI conversion 

Load/Execute User Program # Library 
JMROUTE C180 print file 

JMEXIT 


The command sequence follows: 


EX ZDISssA 

SCL 

LIU, USER=(INTlaNVE) »s PAZ INTLX»s A=NOTUSEDs PR=NOTUSED 
SOL »ADD=NEWLIBRARY 

SPOsMO={BsEoXeS) 2 EA=FATAL 

HCS 

GET »NEWLIBRARYsCYBIILB»s »s»NVE»B56 

GET »XUSORT»s XUSORT»»ssNVEsB60 


ow 
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EX CITOII *XUSORTsLGO* 

EX LGO 

JMRBUTEsNOTUSEDsLOADMAP sPResREMDTE 
SCL 

SOL sDELETE=ALL 

HCS 

GETsCYBILIBsCYBIILBs» »sNVEs856 

EX LGD 

JMROUTE sNOTUSEDsLDADMAP »sPReREMOTE 
JMEXIT 


423 S2_ REGRESSION TEST SEQUENCE 
1) Mount $2 system Scratch pack on 844 Unit 1. 


2) Initialize memory: 


- Set the deadstart panel to disk deadstart ecaas 


CH=1 

UNI T1243 

WORD 1320106 

WORD 1620000 
~- Push deadstart button. 
~ Hit carriage return. 


System should go through a very tengthy 


"CHECK 


COMPUTER MEMORY™ step and then stop and display 


the CMR deck. 


—- Reset panel to desired setting and re-deadstart. 


3) Deadstart Ai70O NOS. 


4) If necessarys update the INT2 catalog and 
fatest system files into the INT1 catalog: 


load the 


~ Mount the INT1 catalog DUMPPF tape on Unit 0. 


= Xe DIS. 
USER» INT1ls INT1X. 
CALL sUPCATS. 
DROP. 


The UPCATS procedure performs the following functions: 
a) Updates the INT2 catalog with the following files 


from the INT1 catalog? 

— the NOS/VE deadstart file (TPXXXK) 

— the "fast fFiles™ for NOS/VE deadstart 
PPIMAGEs RGIMAGE) 


(CMIMAGE> 


—- the command fites needed for NOS/VE deadstart. 


(CMDS2» CMDS2»s CMDS3) 


~- the Remote Host binaries to be SYSEDIT* ed 


into 


the system at the current level (RHLQEPs RHLOSO, 


RHLQOQs RHLPFPs RHLPSO) 


ae 


ae ae Gh Bh 26 He OO HH be UH OM CO 


oa 


Oe £60 26 286 G8 6H O28 2H 4H BH 46 GH 6H OG 6H 4S 46 04 


4-5 
ADVANCED SYSTEMS LN eSSa te PROCEDURES NOTEBOOK 
09/17780 


DO PE PE BE PE PEPE OE PE PE PD PE PEO PE OA PD TE U8 PE 28 BE PA PO GE FAME POPE PATE PE OE PA BE HO PO DE POLO PE OE OF PE DE PE PH ON PO OE FE PE OD TE PE PE PE D8 PE BG PE FE TO TD PE FETE A 


420 NOS/VE HARDWARE REGRESSION TESTING 
423 S2 REGRESSION TEST SEQUENCE 


WO TG PO TE 28 PE IE TE PO PT PA ree DO 0 0 EE PT PE PE ONE 8 OE RE ME OE OE HE PEO ON OO TE ON TO OO OE C8 FE ETE OE TO TOE OE PE 28 8 EON te 


—- the procedure to SYSEDIT the Remote Host 


5) 


6) 


7) 


8) 


9) 


b) 


c) 


d) 


binaries (RHPRECS) 
- the current CYBIL compiler (CYBILT) 
- the CYBIL II object fibrary (CYBIILB) 
— the CI object file used to create CYBIILB 
{(CYBILGO) 
- OSLPI 
LOADPFt*s the ftatest system into the INT1 catalog 
from the DUMPPF tape mounted on Unit 0 
{INT,»D=PE,F=SI»lB=KL). 
Purges the old “fast files" from the Jast INTi 
systeme 
SYSEDIT*s the newest tevel of Remote Host into the 
systeme 


Bring up duat state? 


Test 


XeUPMYVE(CAT#INT1) . 
Kean. (where "*n" is the UPMYVE control point) 


if paging I/0 is working? 

KeDECLARE P POINTER. 

KeSMOPEN P. 

KeCM P ¥*1234#. 

KeMMWMP P, 

-> Disk unit fight shoutd flash on 844 Unit 1. 
KeDM P 100. . 

-> If system is hung at this point then paging is 
not working. 

KeSMCLOSE Pe 


Bring up A170 Remote Host? 


Xs IRHF170. 


Bring up C180 Remote Host? 


Test 


NOTE: 
hence JOB2 cannot be ROUTE'd until JOB1L finishes. To 


KeEX RHINPUT»s 5A. 
Ke EX RHOUTQ8s9Ae 


input file route 7 job exit / output file route? 
X.DIS. 

USERsINTisINT1X. 

GET»REGTESTsTESTBAM,s JOB1,I3082. 
ROUTEsREGTEST»DC=LP»FC=RH. 
ROUTEsTESTBAMsDC=1 Ps FC#RH. 

ROUTE», JOB1l»sDC=LP,FC=RH. 


JOB2 uses the output of JOB1 in its execution; 


determine when JOB1 is finished: 


Hit "*" key to return to K-display.s 
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4.0 NOS/VE HARDWARE REGRESSION TESTING 
423 $2 REGRESSION TEST SEQUENCE. 


The JQB1 dayfile wilt be displayed as the job is 
running. When the system has executed the JMEXIT 
statements J0B1 has finished.j The JOB1 dayfile will 
then be staged back to the 170 side to be printed. To 
print filess do: 

—- Make sure the printer is on (i.e. the START fight. 
is iit). 
—-  FORM325TM. 
ON32. 
(The dayfiles of the REGTESTs TESTBAMs and J0B2 #£jobs 
will also be printed when these jobs finish.) 
Now JOB2 can be submitted? 
— Hit "*" key to return to DIS. 
—- ROUTEsJOB2,0C=LP,FC=RH. 
DROP. 
The JOB2 dayfile will be displayed as it is running. 
When JOB2 finishes (JMEXIT has been executed) do a 
 KeEX ZDISssA- 
to return to the system job. When all jobs have 
finished executing and their dayfiles have printed - 
j2@. the commands 
KeJMSTATUS REMOTE EX. (lists jobs executing) 
K»SMSTATUS REMOTE PR. (lists jobs in print queue) 
return the status "NO ENTRIES FOUND" - then NOS/VE and 
Remote Host may be terminated by doing the following: 
neDROP. (where "n*" is the IRHF170 control point) 
Ke *BYEVE. 


10) Bring down A170 NOS? 
AB. 
CHECKPOINT SYSTEMs 
EosMe {make sure that alli checkpoints compiete) 
STEP. 
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(2) 


(3) 
(3) 
(3) 
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(1) NOS/VE Transmittal Form 


Originator oo CATE ULL CT arget Build 


able <a oanap eae venta 


Code Location: (PACKed Modsets)  FN= 


Stealer Dinan las cece” APN Le 


EG LED AED A AMEE EY RED ES ASL A OS EN 


(Decks in "GROUP" format) FNe_ aa. UN® 


Description File: FN= UN= 


Code Destination (if not NOSVEPL): PL= 


AN ANA ERD OND MEO “SA PONE AOD OPEN OE AON A ARID FRA OND eae SANE AA sane yet ‘iene ataene came staan cage 


em | 


New Feature [(____] Resubmittal. aes Corrective Code [ 


NOS/VE [food A170 NOS fC 


eae | Dual State (C j 


RS RSW OE CO 8 an a eee Se ee a es a Date ee ee 
COMMENTS TO. INTEGRATION . 
Instaltation procedure changes required? [1] 
Dependent upon other features fixs or toot? C 
Documentation changes required? { ] 


OSLPI or Internal Interface changes required? C 


Module{s) to be recompiled 


Has this code been tested? yes oo (3) no UU 
Notes cegarding code submittal: 
{1) Use right margin of form if more space needed. More forms 
are on FN = XMIT1C UN = DEVI. 
(2) Attach copy of description file to form (both 14 7/8 by 11). 
Format is: #MODSET_IDENTIFIER (or NEWLDECK_NAME) (upper case) 
Descriptive text which describes code content 
**DECK_MODIFIED (or NEW_DECK_NAME) (upper case) 
(3) If any of the above are checkeds then explain beiow. 


Code Reviewer 


ne ne ae ee Oe 


ae “oe Chad oe “<2 oe 


ie ia 


nth 


Lda 
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Request Number —. ow 


SOFTWARE CHANGE REQUEST 


Requestor. CATE LL COPSR Number —o 


Software Needing Change 


ee | oe | Stee 5 
S7N 101 NOS ¢. H Integration 3 H Stand-alone 3 ; 
System , nea a Catalog fp merino NDOS/VE. Sete o 
teat Sto Sete 
Installation H : Product Set 3 ; $2 Prototype 3. ; 
Procedures +———- + t—-—--+ Cifosed Shop +———— + 
ne | . oe 2 Steet o 
SES : : A170 NOS 3 : Dual State 3 ; 


Tools eecceer™. System eet System t—-———+ 


TYPE OF PROBLEM BEING FIXED 


+—-———+ $———— + $———— + 
Critical Fix ; H Major PSR ; . Other $ ; 

$+ $———— 4+ $+ 
DESCRIPTION OF CHANGE 


cs Je} 3 ee ee St 2 eG) SA en ee re ear ae eS ee Ge See ee ee En 


DECK US): OUR xin eo ee ee ee ee oe 
{include all 


DESCRIPTION OF PROBLEM BEING FIXED 


BRDU OV CC Gn 


B2 
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INSTRUCTIONS 


The purpose of this form is to initiate a mini-build of the 
requested changes into the current build ftevel. The scope of 
the changes requested and the impacts of making these changes 
must be adequately described. This is the onty way to make 
changes to a system after the feature code cutoff for that 
build has occurred. . 


Requestor: Name of the person submitting the change. 
Date: Date of the request. 
PSR_Number?: Number of PSR being fixed. 


Check those which apply 

SIN_1O1 System: Change affects the ciosed shop NOS system. 
Integration. Catalog: A correction is necessary to the INT» 
INT2,» DEVl» or AL7OINT catalogi{s). 

Stand-alone NOS/VE: Change affects oniy the Virtual State 
execution of NOS/VE. 

Instaitation.. Procedures: A correction to the existing 
Installation Procedures is necessary (ie. such as moving a 
module to a different library) 

Product Set: Change affects an assembler or compiler. 
S2_Prototype Closed Shop: Change is necessary to the system(s) 
provided in the S2 iab. 

SES Tools? Some change is necessary to the SES tools used _ to 
generate systems lie.» Linkers Loaders Simulators etce). 
Al170.NOS. System? A change is required to the A170 Version of 
the NOS operating system. 

Dual State System: Change affects the Dual State software. 


Critical Fix: Fixes a probiem which cannot be avoided either 
operationally» or programmed around. 

Maior PSR: <A serious probtem for which a PSR exists and is a 
considerable nuisance to system users. 

Other: Fixes to nuisances or time wasting problems. 


Modset Identifiers: Name of the modset{s) which need to be 
added to the affected software, 


Decks... Modified: Name(s) of module{s) which require 
recompilation or assembly as a result of this changes 


Description of Problem: A description of the severity of the 
problem being fixeds and the scope of the changes caused by 
integrating this change. 


Approval: Authorization signature for the changes currently 
requires T.C. McGee approval for NOS/VE»s and JeMe Graffius 
approval for A170 NOS. 
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Source Files 


one bt 6 Oe oh Ue 6H HE th Oe Be 4H Oe HE 


3 USER : H ; H 
: NUMBERS +; FILENAMES) + FUNCTION $ VERSION/FREQUENCY OF UPDATE 2. 
Sh a fe en re ef ee a ee ee ene hoe ee ne ee 
H 3 ; H 

+ INTL s NOSVEPL :; MADIFY program library ; Matches the tevel of system. 

: DEVI H ; of Virtual State code : binaries contained in same 

3 : H : cataloge Updated on. periodic 

H ; 3 ; scheduled basis. 

; INTL +; OSLPI + MADIFY program library : Matches the level. of system 

: DEVI : $ of NOS/VE Program $ binaries contained in same 

; H : Interface decks. : catalog. Updated once for 

H : H { each build cycle. 

ere ee se nee ae cee ae ee cee nee ee ee ee ce ce vee ee ae aes le a A A Mn ne sl sa nm sen tee ane ee ta naan ane: momento sa ~s 

: INTL + VELZOPL : MADIFY program library : Matches the level of systen 

; DEV1 : 3; of NOS code which ; binaries contained in same 

; 3 : supports NOS/VE. : cataloge Updated on 

H 3 H : periodic scheduled basis. 
Ce en eo ocean: < ov sna pesaite tam mate mn sate Ap 
: AL7OINT 2 AL7ODPL : MODIFY program library ; Updated on a scheduled basise. ; 
+ LIBRARY + ODPL : which matches NOS : (CPUMTR which supports NOS/VE H 
. H $ system tevel for $2. : is on VE17OPL and not H 
H ; (Installed on FMD $ on this PL). :. 
: : >; unit 43). : H 
a a — ae ee ~———+$ 
3 INT2/INT1 $ PROCLIB : Command Language -$ Matches the level of system H 
: DEVI 3 + Procedure Library : binaries contained in the same - 
H H ; (Documented in ; catalogs and accesses the 2. 
H H ; Integration Proced— ; appropriate build too! 2. 
H 3 +; ures Notebook). 2 versions. Scheduled updates. 3 
ef ne ee -——— ee eee a —+ 
> INTL : NOSLIST :; Contains compiltation/ $s Matches the tevel of system H 
+ DEV1 : + assembly fistings of $ binaries contained tn the 2 
H : ; all Virtual State ' same catalog. : 
H H :; code. Accessed via : ; 
H ; ; LISTNVE procedure. ; 3 
Sm ce in a a ae i a a a fe a nn a ne a ee ae ec ee 
: INT1 : MTRLCBsEIELCBs ! Linker directives files {$ Matches the tevei of H 
; DEVI + EILCBsSTSLCB +; for monitors : system binaries contained :. 
: ; LIBLCB ; error interfaces : in the same catalog. :. 
H H ; task services»s and 2: EI is built using the 3 
H : : user modules ; BLDEL procedures white 3 
; : ; respectively. 3; NOSBILD is used for EIE. ’ 
ne. 
3: INT1 : NEWDKPL +: Meaningless Madify : Nevers disappears when SCU H 
: DEV1 : +; program library + conversion is compltete. ‘ 
3 H ; Which users may H H 
H H ; substitute for ; H 
; ; i as an alternate ; ; 
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Source Files 


+} base when using 
3; Integration compilation 
; procedures. 


: 


woh oe @e 
beh O28 be - 


INT2/INT1 
DEV. 


Each Velink of a Dual 
State system. 


MAP_offset_k Contains tink map of 
Dual State system 
createds where MAPOK 
is a standalone NOS/VE 
system and MAP256K 

is a 256K NOS Dual 

+ State system. 

ee aa een ann emcee a me ae am <a ll A A A ee a <A Ail A SE A SO I A as ean a Alp A A 
INT1 : VQLTST3 Contains simulator 
DEVI commands for a 
batch mode test 

of the NOS/VE 

; system. 


#6 ee OO OC BH €H HH BO 
ete oe Oe Oe ee we ow 


oe O26 84 OS Oe 4H OH Go 


\ 


OE AE ES OD A AAD RAS RD HON IE cca 


As required by system 
content changes. 


eb oe ee we ee hh OE Oe OH Oe Oe EK we Be HH He Be HE 
ae 64 be ae tt 
eo ae OH ae ee 
a6 oe me ae oe 
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Se ce re cc meee ce eee a ae fp ne ee ce ee ee se me ee cane a eS a me el se Se A A Om ets <a emt natn se Aa ES SOR AN IO ena OR SO te -O- e  see 
2 INT1 ; LOR_offset_K ; Contains VE generator +. As required by system 

: DEVI ; ; directives for Dual ; content or structure 

H H ; State offset loads. ; changes. 

a es pee ee cen cee ee a a ee se te a ee ae me ee ee ce re os ee ce cn ee a ee te a sn ae ce wees se ee ee ON A A ES A he Ag ORS ee te 
: DEVI : KEYDESC + Contains Keypoint : Non~standards updated 

H : ; descriptions for : upon development's request. 

H H : the Keypoint report H 

H H + Program XXM7KEY. 2. 

Sn a hf a ef nn rn oe ee ee ee 


Files mainta 
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ee Oe 28 HH we 
Oi 
mt 
ms 
po 
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INTL 
DEV1 


INT1 
DEVi 
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INTL 
DEV1 


INT1 
DEVI 


he Oe Oe be Oe OE be oe Oe OE OO Be OS BS Be HO OO OH Ot we bE bE Oe ee we i Oe 4S be be 


INTI 
DEVI 


aoe oe ae 


ined by Integration 
Files 


XLMMTR Object text file 


of modules which 


be te ow ah ae 


mode... 


XULJLIF»s xXLJ12F 


XLJI1L3FaXLJIFF of task services 


ring attributes 
L1IF»12F,13F and 


ae OH be Oe 6 Oe ne bp 6 ee ee 


2 
4 
H 
a 
a 
+; job mode with 
; 
3a 
a 
; 


+ XOLGsXSCL» 
XLLMCII 


and Object Text 
converter. 


eT eo ee ee 
oe oe we Oe Oe oe ow ee oe 


STS XHDR » 
EIEXHDR» 
error interface 
segment files» 
produced by 
VELINK. 


MTRXGST» Qutboard symbol 
STSXOSTs table files for 
EIEXOST monitors, task 


servicess and 
error interface 
produced by 
VELINK. 


Om 84 we Be Be Ae Be db St ee Oe EO Oe Ow Ue wee 


oe 08 86 66 ae be we Be 4H we Be HH Hew 


e a 
4 


3; STSX101 thru. ; The task services 
:; STSX118 + segment files 

: + produced by 

; + VELINKs 


a 


: MTRX101 thru +; The monitor 
MTRX105 > segment files 
: produced by 


execute in monitor 


Object text files 


modufes which run in 


1FF respectively. 


Sf 
Object text files 

of the Object Library 
Generators System 

Command Languages 


XUCNTL» XUTEST» Object text files 
XUSORT»s XUUXERI» of user test 
XUUTL»XUVLEX» programs added 
XUVLEX2 to the systeme 


MTRXHDR» +; Header files which 
name the monitors 
task services,» and 
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Each recompilation of a 
monitor mode module. 


ee ee 
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Each recompitation of 
a task services 
module within these tibraries. 


£ach recompitation of 
these utilities. 


8 Be Oe Cn HH oe bh Be be Oe OF HH Oe Oe 
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tach recompitation of 
these tests 


Each Velink of the 
system. 
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system. 
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$ Each Vetink of the 
; systeme 
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Object Text Files 
3 3 : VELINK. ; ; 
INT 3; EIEX101 thru : The error inter-— 3; Each Vetink of a 


DEVI EIEX102 face segment Dual State system. 


Files produced 
; by VELINK. 


ae ee ae w& 
oon oe 


oe we oe we 


CC ee ee ee) 


Non—standard ISWL 
NGS/VE Keypoints utility. 
encountered during 


.a@ simulation: rune 


a 
+ 
: INTI : XCPUMTR 3; Al7O NOS CPU Each recompilation due to 3 
: DEVI H $; Monitor module modset corrections or H 
H H ; binaries. changes to the base A170 2. 
H 2 H NOS tevel system... H 
eS a Sa a a a ef ee en ee ee nf 
: INT2/INT1 3} LGBLoffset_K ; The Virtual Envir- +; Each VELINK/VEGEN ; 
: DEVI H ; onment file pro- : of the systems 2. 
: : ; duced by VEGEN. :. ? 
>= sa aemtieatemmenteenti ohmarimetametnmedtesssematometmetben toe tamianeteratenedamttonstenate dtenntonamtenhenntenmnematoney seca ene “ean tee ete a seastapmeheeesiemmetemadibe stammatennddenneteamansieneteanmnnstonadhaenstemthmeniomatamnsesteaehandmenteentene tenehreinentntnenemaenatenntimeateemtmatmaientent, a 
: INT2/INT1 3 CKPT : The checkpoint file : Each batch mode simul- H 
: DEVI ; : From the last : ation of NOS/VE. 2. 
H : : simulation run as a : ; 
H H ; resutt of running : : 
: ; $3 the VQLTST3 test 3 2. 
H $ + commands. H H 
ee ene ence ee a ne oe ne rane ee eee eae nee meen ti in te RS AES A i SS nn ee came nef ne ee meer se ste A Se LE OO Ne A em 
3 INT2/INT1 $ CKPTO thru : The simulated disk ; Each batch mode simul—- 
: DEVI + CKPT2 + files produced : ation of NOS/VE. 
7 H + during the batch ; 
H ; $ mode simulation H 
; ; ; sf une : 
Sm a ee a ef ee i ie fa ee ee ae ee - ~ —— 
3 AL7OINT +; NOSTEXT +; A170 NOS system : Each A170 NOS update. 
H ‘ : text for current H 
H : ; NOS version. H 
Oe nn ee ooo ae eamtieeetoentaeeenenntemssaeetomtnetnatetaatieentzentieati cman atenetieseea tresses etme ee en ead 
H 1 
DEV1 XXM7TKEY Program to report 2 
a 
3 


£4 ©” £2 264 OO 


DEVI ' XXM7DSI * Standalone version ! Non—standards 
: ; of NOS/VE deadstart ; unsupported. 
H : file generator. H 


| 
! 
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SO he #8 be be pH Oe 64 Oe oe we oe ft Oe ae Oe Oe oO ht Be A we hh SS OH 4H HO Oe 


DEVI ; XXDSGEN ; Dual State ; Upon demand. 

; : deadstart file :. : 

H ; generator. H 

ef a a ae re ee eee _ 

DEVI +: XIDSTsXIDSK>» ; CYBER 180 PPU + Upon demand. 

+ XIDSPyXIHLP » > Programs. 

4 € 

: ] 


XTRES ’ 
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: 
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INT2/INT1 $3 TPLof Fset_k :; Dual State 
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Object Text Files 
: DEVI ; : deadstart file ; deadstart file is H 
; ; 3 created by the NOSSYS + generated (upon .. 
H : $ procedure. $ demand). ; 
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This paper represents the beginning of a thetpfuil hints on how to 
do your job's document. Some of the areas discussed are still. 
incomptete. I will be periodically adding information to the 
document. If you have any qustions or suggestionss please see Tom 
McGee. Appendix A lists background documents and how to obtain 
them. 


Update History 


Date Changes 

2/8/80 Section 3.0 revised 

24/12/80 Appendix A Section 3.3 corrected 
2713780 Section 1.0 revised 


9711780 Section 3252228 reviseds Section 325222824 added 
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£1.20 DOCUMENTATION FOR RUNNING ON S2 


E1.0 DOCUMENTATION FOR RUNNING. ON S2 


Elel STANDALONE NOS/ZVE 


Topic Document 
1» Standalone NOS/VE HW/SW Dn bulletin board 
Configuration in $2 area 
2s Integration Procedures Notebook NOS/VE User*s Guide - 
Build Procedure Appendix A 
3. Deadstart Panel Settings (Real On deadstart panel. 
Panels CMSE Emulated Panel) 
46 Standalone Deadstart Procedure JFS Paper —- Section 2.0 
5. Standalone €C545 Operator NOS/VE User's Guide — 
Consote Interface Appendix A 
60 Debug Mode Interface NOS/VE User*s Guide 
Appendix A 
Ts Standatone Dump to NOS/VE Printer NOS/VE User's Guide 
Appendix A 


Be How to Analyze a Standalone NOS/VE Dump 
96 What To Do If? 


o NOS/VE abort 
o NOS/VE hung 
o Cantt deadstart JFS Paper — Section 2.0 
o HW errors JFS Paper — Section 2.0 
o Unrecovered disk errors JFS Paper — Section 2.0 
etce 
10. Detailed Documentation for EC Register (Machine Dependent) 
11. Patching Memory 
E1.2 DUAL STATE NOS_AND NOS/VE 
1. Dual State NGS and NOS/VE Dn bulletin board 
HW/SW Configuration in S82 area 
2s Dual State NOS/VE Deadstart Integration Procedures 
File Building Procedure Notebook 
3 Deadstart Panel Settings 
{Tape and Disk) On deadstart panel 


4e NOS A170 Deadstart Procedures KM Paper —- Section 3.1 


E1-2 
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E120 DOCUMENTATION FOR RUNNING ON $2 
El.2 DUAL STATE NOS AND NOS/VE. 


5 8 
6. 
Te 
Be 


Ge 


10. 
ll. 
12. 
13. 
14. 


15. 
16. 


17. 
18. 


19. 


20. 


21. 


NOS Operator Command £& NOS Operator's Guide — 

Display Interface Appendix A 

NOS DIS Interface NOS Operator'’*s Guide 
Appendix A 

NOS 026 Interface NOS Operator's Guide 
Appendix A 


CTS Interface (Simulated TELEX ASCII Terminal 

from Operator Console) 

Dual State Initialization (UPYVE)>, WHB Paper -— 
Operation (RUNVE) and Section 323s 345 
Termination (TRMVE) 

UPVE Command File Format (Configurations Memory 


Patchess NOS/VE Commands) WHB Paper 
MCU (DKD) Commands and Displays WHB Paper 
K Display Operation of NOS/VE WHB Paper ~- Section 324 
NOS Error Messages NOS Diagnostic Handbook 


Appendix A 
LOADPF/DUMPF to Move PF's Between SN101 
and $2 (Non standard) KMJ Paper-Section 3.1 
How to Analyze a Duai State Dump 
What To Do If? 
o NOS abort 
NOS hung 
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O STANDALONE NOS/VE_DEADSTART 


1 GENERAL PROCEDURE FOR DEADSTART (OVERVIEW) 


1. Mount deadstart tape 

2 make sure microcode (firmware) is loaded into the P2» 
tape controller and disk controller. 

32 Mount scratch pack{s) on HCS disk drivef{s). 

4s Press deadstart button. 

5 Make sure P2 DEC register and M2 BR {bounds 
register) are set correctly. 

6b» Start CPU running 

7a. Verify proccessor is running 


7b. Take dump of memory. 


usually not necessary 
not necessary except on list deadstart 


2 DETAILED PROCEDURE FOR STAND-ALONE DEADSTART 


Mount deadstart tape 
o mount on UNIT O (other units can be used if tocation 5 of 
the deadstart program is set appropriateiy. See step 5). 


Set up the deadstart panel for CTI deadstart from diske_ 

o use the "DISK deadstart’® switch setting. Switch settings 
are pasted to deadstart panel. 

o the channel-Eq-Unit setting of the deadstart program must 
reflect the location of the CE pack referred to as "ARH 
Regression!t diske The disk should be mounted on Unit 4. 


Mount the scratch pack(s) on the NOS-VE disk drive{s). 

o currently the OS is set up to run with 1l-double density 
disk on unit 1-e This can be changed during deadstart 

o use the pack labeled 'HCS scratch! 


Make sure microcode is loaded in the P2-. 
o (DS) Press deadstart buttone You should see a dispiay that 
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6» 


Te 


says: 


‘CI AAO =A aD PENS AER AN CL SAEED IR “SOON UNEASE ELEN “RANEY SORE ALBEE RETR TAR EBT catty 


(CR) —- GS toad 

0 —- Deadstart auto 
U— Util 

M=- Maint 


If nots check deadstart 
panely disk unite Try 

fong DeS» seqe Reconf 
PP*s. toad disk cntri 

cntriware.e 


se eh bt we 


} ee oe 44 we 


o Type 'M*. This causes another display to appear 

Type *{CR)° 

o At this point it is sometimes wise to preset memory. Type 
KC 09100000», eeeeeeeereeeeeee (CR) 
and wait until lower left of display is static - takes 10 
to 20 seconds. . 

o 6 Type *60 INSTRN (CR)*. Wait until fower ieft of disptay is 
static. Takes 5-10 seconds. 


° 


Now you are ready to deadstart NOS/VE.~ Subsequent deadstarts 
will start with this step. 

o {(DS) Press deadstart button 

o Type 'M? 

o Type *DOST(CR)!# deadstart panel settings appear 

o Type *52#12ut(CR). (tut is the unit number of the deadstart 
tape.) 

Type "(BKSP)! 3 times to clear the screen 

Type *#(CR)* Tape should start moving. If nots 

0 check unit 

0 go back to step 4 

o try another tape 

o call for help 


Oo 86 


Message *PROCEED* should appear on the screene At this point 

afi NOSVE PP code has been Yoadeds processor registers are 

foaded and central memory is loaded. 

o If tape moves a fot but *#PROCEED* doesn't appear» call for 
help. 

o Type "DR»eP2(CR)I*'*. If the vatue of the SIT is changings ali 
is well. If SIT is not changings repeat steps 39 42 52 If 
it stili isntt changings call for help. 


If this is the First deadstart since a non-NOSVE user used the 

machines make sure the P2 EC register and the M2 BR register 

are set correctly. . 

o Type "DR»sP2(CR)*. This brings up a display of P2 registers 

o Type *CReP2eEC2O8FF_ 00004502. 6000 (CR)I*. You should see 
the value being displayed for the EC register change to the 
vaiue specified above. 
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E222 DETATLED PROCEDURE FOR STAND—ALONE DEADSTART 


o Type "DR»oM2(CR)I*. This brings up a displayof M2 registers 
o IHIf any register has a non-zero value in its set it to all 
zeros» 


Be At this point hex patches can be entered from the consolie or 
card reader to fix software problems or to change the values 
of system constants. If you are fucky you can skip this 
step. Patches which may be necessary are? 

o CF,» 20282X000 0000 0000 0006 where X specifies the unit 
number of the disk({s). {X=8 for unit O» X*4 for unit ly» 
X=2 For unit 2,5 X=1 for unit 35 X=3 for units 2 and 3s 
etc.) 

o CFs2020=0000 OOXX OOmm 0000 where mm = amount of. memory to 
use in hex megabytes. Default is 2. The value of the XX 
field must not be changed from what is initially there. 


9s Type *FSS(CR)?' to start the CP running. 


10. Type *DD{CR)I® to look at the dayfile for the system jobe 
Values in the header should be changing. 


If the display header is changings all is well. Go to step 

11. Otherwise either hdw or sw iis brokene 

Type "'DR»P2 (CCR)*. . 

o If PFS» CELOs, CEL1 are non-zero, its probably a hardware 
problem 

o The value of P will indicate where you got to in software 

0 Type *DR»O {CR)*./ Location 0 of CM contains the XP that 
was executing when the processor halted. The XP dumped to 
foc DBD does not contain P» ise.» word 0 is ADe took at the 
MCRIUCR. . 

o Type #DRoM2(CR).~ If UCOl or UCO2 are non-zeros its 
probably a memory probiem,. 


ll. You are in the idie toop.e Type some commandse (Same commands 


you type if on the simulator. Additional commands processed 
by the PP are also available.) 


E223 DISK ERRORS 


The system cannot handie ali disk errors. If the CPU halts» you 
can determine if the halt was caused by a disk error by doing the 
following: 


o display iocation 2008 
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o 


The teft half of this word contains the RMA of the mtr halt 
msg that describes the reasons for a yoluntary monitor 
hait. If monitor did not voluntarily halts word 2008 wilt 
contain OQOOAOOFFO7D0000. (Capprox) 


Display the location pointed to by ftocation 2008 (left). 
If the location contains 


xx 73713031 e202 (ASCII for ppSQ01 —- 39 where p is a 
descriptor for the string) 


then you haited because of a fatal disk error. 


9 


The cylinders tracks sector of the bad spot is in the 2nd. 
word of the message pointed to by loc 2008. Word 2s 3 
contains 

xx00 Ou00 ccO0 tt00 

$s00 0000 0000 0000 
where 

u = unit number tt ~— track 

ce = cylinder ss ~ sector 
To ‘down!’ the bad spots after each deadstarts TYPE 
FMDOWNAU uc t O 5 
u = unit +1 from halt msg 
cst»ss = decimal representation from halt msg. of cyl» 
tracks sector. 
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E320 QUAL STATE _NOS/VE_DEADSTART 


E301 A1ZO_ NOS _DEADSTART 


1) The system is configured te run with three FMD units (4ls 42, 
and 43). No 844 drives are needed. 


2) Turn off all 844 disk drives. teave the FMD devices one 


3) Set the O/S panei to deadstart from the primary system disk. 
(CH=1ls Unit=41 or 43. See console or bulletin board for a 
description of which h disk contains the primary system. 
Set the D/S panel word 14 to RPXX 
where R = D/S tevel (0 or 3) 
P = 1 Gf you wish to see the CMRDECKs P = 0 if note 
XX = CMRDECK number 

For the first deadstart in a session use "0006" 

Set word 16 to 00001 


4) Push D/S button 
5) Select "0" display and then select "H*" dispiay 


6) Set "CS = NG" onty if you don*t want microcode te be loaded. 
After the initial deadstarts, loading microcode isntt 
necessar ye 


7) Enter a "backspace" 


B) Select "P" display 
Here you may set "[=3" for recovery level deadstart 
{Use I#0 for first deadstart) 
Set "D=Y" to see CMRDECK.» This may be needed if you wish to 
see or to change the current system configuration. 


9) Enter "(CR)" and the system should deadstart. You should then 
enter the date and time when the system displays these 
requests. 
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£3.2 CURRENT DUAL _STATE CONFIGURATION 


o FMD Unit 43 
This unit contains the Following? 


—- A170 NOS» CTI» CMSE»s EI binaries (NOS deadstart files) 
~ Files associated with user number LIBRARY 
~ Files associated with user number SES 


o FMD Unit 42 
This is a scratch unit. 
o FMD Unit 41 | 
This unit contains the following: 


- A170 NOS» CTI»s CMSE»s EI binaries (NOS deadstart file) 

~ Files associated with user number DEVI 

—~ NOS/VE Development Area PL*s and Member PL*ts 

~ NOS/VE Deadstart Files to be tested (saved in individual 
user's catalogs) 


£3.3 DUAL STATE2 NOS OPERATION 


1) The convention used for creating user numbers on NOS/VE is as 
follows: 


o Your user number will be your initiatis. 

o Your password will be these 3 letters followed by the tetter 
ty?, 

o You must see Integration to be assigned a user index 


User numbers are created by executing the program “MODVAL" as 
follows: 


o Type "X.MODVAL". 

o Type "Kame" where m is the MODVAL control point 

o Type "Ke»eCsuuue” where uuu = your user number. Note that. the 
"Ke" stays on the screens 

o Type "K»PWtuuuxs FUI=ne"™ where n = your user index 

o Set all other parameters to their maximum values. Do a "#4" 
to see next page -— there are 3 pages associated with a user 
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number. 

o Type "KsEND." to end creation of that user number. Another 
user number may now be created. 

0 Type "K.END.” again to exit MODVAL. 


2) PF dumping and toading 


You may use "SES»DUMPPF® on SN/Y101 to dump your permanent fies 
to tapes and then load them onto your user number on A170 NOS 
using "SES»LOADPF". Documentation on how to use these SES 
procedure and what their parameters are is included in the SES 
"User's Guides or they can be obtained by typing? 


"SES sHELP.DUMPPF™ and "SES»HELP.LOADPF®". 
£304 NOS/ZVE DEADSTART 
1) The following file must be available in your catalog on the $2: 


TPXXXK contains a NOS/VE deadstart images This must be a copy 
of the dual state deadstart images avaitabie from the link 
procedures. 


CMIMAGEs PPIMAGE»s RGIMAGE are “"fast™ filess which are built 
from TPXXXK the first time you deadstart NOS/VE. These files 
are then used on subsequent deadstart attempts. Sefore a new 
TPXXXK can be used» these *"fast™ files must be purged off your 
user number. 


2) Piace a SCRATCH disk on 844 drive number 1. 
3) Type X.UPMYVE(CAT=uuu) where uuu is your user numbers 
4) The UPMYVE job will display the following? 

REQUEST *K* DISPLAY on the B display 


Type Kene where n is the control point number of the UPMYVE 
jobe 


5) Type Ke*¥PPLOAD#=TRUE. if you want to toad and use disk 
drivers. Default is no driver. This is a reminder to perform 
step 2.2 This must be entered if you wish to buid the fast 
files mentioned in step 1. 
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6) Type K.»e*RUN. Note that the deadstart that creates the fast 
fite will take 1-3 minutes to complete. After the fast files 
are builts it usually takes about 30 seconds. 


E3.5 NOSZVE OPERATION 


E32521 COMMUNICATION WITH A NOS/VE JOB 


E325.1.1 Job Dayfile Display 


Type 

K*EX ZDISBsasA. 

where n is the number of the job. 

To bring up the NOS/VE “"B" dispitays enter: 
Ke*VEDISPLAY=CP. 

Jo return to the NOS/VE dayfile displays enter? 
Ke*VEDISPLAY=DAYFILE. 


E3.5el22 Sending Commands 


Type 
Ken=XxXXe 
where n is the job number and XXX is the NOS/VE command. NOTE? 
XXX cannot contain periods. 
E325e2 USING THE REMOTE HOST 
~The 180 side of the remote host is inciuded in Buiid G of NOS/VE 
and subsequent builds. To use its NOS/VE must be up and running. 


To initiate the current NOS/VE builds type X~UPMYVE{CAT#NVE). 
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The 170 side of the remote host is inciuded in the NOS 170 
system at deadstart time, 


E325e221 Bring Up C170 Remote Host 


Type 


£3.2542222 Bring._Up_€180 Remote Host 


Type 


Kayne where n is the UPMYVE controt point number. 

KeEX RHINPUTs sA. 

KeEX RHOGUTQ8B 5s sA~% 

RHINPUT is the 180 task which receives job input files from. 
the 170. 

RHGUTQ8 is the 180 task which sends print files to the 170. 


£32523 Route An Input File From. €170_To_€180 


Through the system consoles enter: 
Type 


X.DIS. 

USERsAs Be 

GETsfilename. where filename 
identifies the input file to 
be routed. 

RDOUTEsfFilename,sDC =LP»FC=RH. 


If you are running from an interactive terminal, enter: 


GETsfiltename. 
ROUTEsfilenamesDC =LP,FC#=RH,. 


The input file which is sent to the 180 must be in Disptay Code 
{64 character set ~— upper case oniy). The job file must be a 
singie partition 170 record contaning NOS/VE commands. Multi 
partition input files sre not yet supported by NOS/VE so 170 data 
files used by the program must be obtained through the NOS/VE 
permanent file GET command. The fast command of the job file must 
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be JMEXIT in order to cause the job to terminate property. Support 
for ASCII job Files (6/712 ASCII) will be added at a tater build. 
The asterisk character should be used in place of the quote 
character to delimit parameters for the NOS/VE EX command. 


E30e5e2e% Route A Print File From. C180 to C170 


At NOS/VE job termination the job tog (dayfile) wit! be 
automatically returned to the 170. Data written to the NOS/VE- 
output file $OUTPUT will be overwritten by the job tog so ail 
program print output must be written to alternate files which are 
explicitly routed to the 170 with the JMROUTE command. NOS/VE 
print files must be written by BAM as 8/8 ASCII RT#W. Print files 
will be converted from 8/8 ASCII RT*«W to Display Code (64% character. 
set - upper case only) when they are sent to the 170. Support for 
ASCII print files (8/12 ASCII) will be added at a tater build. Ali 
NOS/VE output files will appear in the 170 output queue (NDS HsO 
display) with the name I[RHFxxx as a banner. In order to route a 
NOS/VE print File to the 170» the following command must be 
contained in the 180 job file or be entered from the system console 
via the K display: . 


JMROUTEs jobnamesFilenamesPR,REMOTE 


jobname — name that the print file will have in the 180 output 
Queues 


filename — name of the local 180 file created by BAM that is 
to be printed. 


PR ~ specifies that the file is a print file (must always be 
PR). 


REMOTE — name of the 180 family for the print file (must 
always be REMOTE). The NOS command ianguage must be in 
HCS mode (HCS command) in order to enter the JMROUTE 
command. 


Example of JMRBDUTE command: 
JMRGUTEsLISTINGsLINKMAPsPReREMOTE. 

On the C170 sides the printer must be physicatly and 
fogicaily one To togicaiiy turn the printer ons under DSD 


enter: 
QON32- 


$2 Mac 


Pe One oe re et 


£3.20 D 
£32502 


PO PE 20 00 08 


E3. 


NOS 
spe 
per 
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FORM32_9TMe Cin honor of our illustrious leader» Tom 
McGee) 


5e2e5 LINK_USER Command 


In order to access C170 permanent files from a C180 jobs the 
JVE job must issue a LINK_USER commande. The LINK_USER command 
cifies the user identification on the 170 under which C170 
manent Files will be accessed. 


The following must be done to enter the LINK USER command? . 
SCL. 
LIUsUS=(usersfamily)s PA=passwords Azaccounts PR=eproject. 
HCS. 


The SCL command puts the NOS/VE command processor into SCL 


modes The HCS command puts the NOS/VE command processor into HCS 


mod 


pas 
to 

can 
par 


{HCS mode is required for the GET and REPLACE commands). 


The LIU (or LINK_USER) command specifies the NOS users familys 
swords account and project parameters which are used by IRHF170 
create 170 jobs which access C170 permanent filese A NOS/VE job 

issue only one LINK_USER command per 170 family. Ait LINK_USER 
ameters are specified with keywords and all are requied. 


US tor USER) -— This parameter specifies the NOS user number 


(cataiog) and family in which the 170 permanent files reside. 


fus 


er' wili be the first parameter on the 170 job*s USER card and 


*familyt will be the second parameter. Currently the only family 


on 


the $2 Oual State system is called NVE. 


PA (or PASSWORD) This parameter specifies the password that is 
used to login to the user numbere ‘password! will be the 
third parameter on the 170 job's USER card. 


A or (ACCOUNT) This parameter specifies the account number 
(charge number) for the 170 job.j It will be the First 
parameter on the 170 job's CHARGE card. 


PR or (PROJECT) This parameter specifies the project number 
for the 170 jobek It will be the second parameter on the 
170 job's CHARGE card. . 


Note: When running on the Simulators the LINK_USER command is 
not required to use the GET and REPLACE commands. 
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Exampie of LINK_USER command: 


SCL. 
LIUs,US*( FABsNVE )» PA=FABXs A=71369 PR#=73E08802. 
HCS. 


E3e5e226 Get_A_170 Permanent File From.1890. 


The GET command obtains a copy of a permanent file residing on 
the 170. The 170 permanent file can be either a direct or an 
Indirect access permanent file. The NOS/VE command processor must 
be in HCS mode (HCS command issued) in order to use the GET 
command. A!il parameters on the GET command are positional. OGnty 
the 'lfn* parameter is required. A LINK USER command must be 
issued (for the 170 family on which the permanent file resides) 
prior to issuing the GET ccmmand.s The format of the GET command. 
is: 


GETsifnspfnspwasunsfmscd. 


ifn (local file name) ~ This is the name of the focal NOS/VE 
file to which the 170 permanent file will be transferred. 


pfn (permanent file name) ~ This is the name of the 170 
permanent file that is to be accessed. If this parameter is 
omitted then tifn® witl be used for the 170 permanent File 
namee 


pw (password) - This is the password that will be used to 
access the 170 permanent file if a password is required to 
access the file on the 170. 


un (user name) —- This is the user name (alternate catalog) on 
which the 170 permanent file resides. 


fm (family) - This is the family on which the 170 permanent 
file resides. Currently the only 170 family on the S2 Dual 
State system is NVE. 


ca (conversion alternatives) - This parameter specifies the 
type of conversion that is performed by the IRHF on files 
transferred from 170 to 180. If this parameter is omitted 
then a default of B60 will be assumede Values for this 
parameter are: 


B60: Basic Biary 


oe 
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The full 60 bits of each 170 word are transferred to the 
lower 60 bits of each 64 bit 180 word. The upper 4 bits 
of each 64 bit 180 word are set to 0. The file is written 
to 180 using BAM with Biock Type = System (Unblocked) and 
Record Type = Undefined (RT#U) so no control information 
is inserted in the file. The 170 logical record structure 
is dropped (i.es.» EORS are deleted causing the logical 
records to be packed together. 


B563 C180 Binary 


The lower 56 bits (7 8 bit bytes) of each 170 word are 
packed into contiguous 8 bit bytes on the 180 (i.ees 7 8 
bit bytes from the first 170 word and 1 8 bit byte from 
the second 170 word go into the first 180 word etce). The 
170 logical record structure {E0ORs) are dropped. The way 
that the 180 file which was transferred from 170 is 
accessed should correspond to the method used to create it 
on the 180 originally lassuming that the file originated 
on the 180). 


A6? 6/12 ASCII 


A170 6/12 ASCII character files fused by XEDIT and most 
SES utilities) are converted to 180 8/8 ASCII with Block 
Type = System (Unblocked) and Record Type = Variabie 
(RT=W). The 170 logical record structure EORs are 
dropped. 


A8: 8/12 ASCII 


170 8712 ASCII character files are converted to 180 878 
ASCII with Block Type = System (Unbiocked) and Record Type 
=z Variable (RT#W). The 170 logical record structure 
(EORs) are dropped. — 


D64:?: Dispiay Code 64 Character Set 


170 Display Code character files are converted to upper 
case 180 878 ASCII with Block Type = System (Unblocked) 
and Record Type * Variabie (RT2W). The 170 togical record 
structure EGRs are dropped. 


Example of GET command: 
SCL. 


LIUsUS#(FABsNVE) » PA@FABX9 A=71365PR273E08802- 
HCS. 
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GETsTEXTs TEXT612s »sNVEs AG. 


Note: When the GET command is used on the Simulators the 
file specified by the "'pfn* parameter must be a 170 
file which is locat to the simulator job. 


—=E3e5e2e7 REPLACE A_170 Permanent File From_.180 


The REPLACE command transfers a copy of a 180 local file to a 
permanent file on the 170. If a permanent file of the same name 
does not exist for the specified user {(catalog)»s a direct acccess 
permanent file is created. If a direct access permanent file of 
the same name already exists in the cataiog and the file can be 
attached with write mode then the existing direct access file is 
overwritten with the file from the 180. If an indirect access 
permanent file of the same name already exists in the catalog then 
the indirect access file is replaced by the file from the 180. An 
existing indirect access file will not be changed to a direct 
access file if the user's indirect access file size limit is 
exceeded. The NOS/VE command processor must be in HCS mode (HCS 
command issued) in order to use the REPLACE command. Ai} 
parameters on the REPLACE command are positional. Oniy the *tfn? 
parameter is required. A LINK_USER command must be issued (for the 
170 Family on which the permanent file resides) prior to issuing 
the REPLACE command. The format of the REPLACE command Is: 


REPLACE s I fnepfnspweunsfmscas 


tfn (focal file name) —- This is the name of the local NOS/VE 
fiie which will be transferred to a permanent file on the 
170. 


pfn {permanent file name) — This is the name of the 170 
permanent file that is to be created or replaced. If this 
parameter is omitted then tlfn*® will be used for the 170 
permanent file name. 


pw (password) - This is the password that will be associated 
with a newly created direct access file or which is used 
to gain access to an already existing direct or indirect 
access permanent file. 


un (user name) ~ This is the user name (catalog) on which an 
existing 170 direct or indirect access file resides. This 
parameter is illegat if the file does not existe 


fm (family) - This is the family on which the 170 permanent 


ee 
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file is to reside. Currentiy the onty 170 family on the 
$2 Dual State system is NVE.- 


ca (converion alternatives) —- This parameter specifies the 
type of conversion that is performed by the IRHF on files 
transferred from 180 to 170. If this parameter is omitted 
then a default of B60 will be assumed. Values for this 
parameter are: 


B60? Basic Binary 


The tower 60 bits of each 64 bit 180 word are transferred 
to the full 60 bits of each 170 word. The upper 4 bits of 
each 64 bit 180 word are discarded. The 180 file which is 
to be transferred should be written by BAM with Biock Type 
= System (Unbtocked) and Record Type = Undefind {(RT*U). 
The file is transferred to the 170 as a singie logical 
record (i.e. fFfiies with multiple EDRs cannot be created 
on the 170 from the 180). 


B56: C180 Binary 


Groups of 7 contiguous 8 bit bytes from the 180 will be 
transferred to the tower 56 bits of each 170 word (i.ee 
the first 7 8 bit bytes from the first 180 word go to the 
lower 56 bits of the first 170 words the 8th 8 bit byte of 
the first 180 word and the first 6 8 bit bytes from the 
second 180 word go to the tower 56 bits of the second 170 
word etc.). The way that the 180 file to be transferred 
is created does not matter because the entire structure of 
the 180 file is preserved on the 170. The file is 
transferred to the 170 as a single logical record. 


A6? 6712 ASCII 


A 180 8/8 ASCII character file with Block Type = System 
(Unblocked) and Record Type = Variabie (RT=W) is converted 
to a 170 6/12 ASCII file (used by XEDIT and most SES 
utilities). The file is transferred to the 170 as a 
Single logical record. 


AB? 8712 ASCII 


A 180 8/8 ASCII character file with Block Type = System 
(Unblocked) and Record Type = Variable (RT#W) is converted 
to a 170 8/12 ASCII file. The 170 file can be routed 
directiy to the printer with the 170 ROUTE command with 
the EC#A9 parameter. The file is transferred to the 170 


ae 
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as a single iogical record. 


D643: Display Code 64 Character Set. 


A 180 878 ASCII character file with Block Type = System 
(Unblocked) and Record Type * Variable (RT#W) is converted 
to a 170 Display Code file with fower case characters 
mapped to upper casee ASCII special characters that do 
not have a Display Code equivalent are converted to 


Display Code bianks. The 


file is transferred to the 170 


as a single logical records 


Example of REPLACE command: 


SCL 


LIUs,US=(FABaNVE )s PA*FABXsA*71 369 PR*73E08802.. 


HCS. 


REPLACEsMYFILEsFILEB56ss»sNVE»sB56~4 


Note? When the REPLACE command is used on the Simulator, the 
file specified by the tpfn*® parameter will become a 170 
File which is ieocal to the simulator job. 


E325e2.8 Exampie Jobs Representing Phase A/B Library Creation/Modi 


Generai Notes 


¢ 


0 


0 


HCS command causes NOS/VE to switch to HCS command tanguage 


interpreter 


SCL command causes NOS/VE to switch to SCL command language 


interpreter 


Comment capability within command line is not currently 


available 

HCS comment tine format (starts 
compatible 

The B60 conversion parameter on 


with singie quote) not SCL 


the GET command is utitized to 


indicate that the A170 file is to be transferred to NOS/VE. 


without conversion 


The NOS/VE job command stream must use dispiay code 


The B56 conversion parameter on 


the REPLACE command is utitized 


to indicate that the 64 bit oriented NOS/VE file is to be 


transferred to the A170 without 
data bits are stored in each 60 
The B56 conversion parameter on 
indicate that an A170 file with 
A170 word are to be transferred 
NOS/VE File. 


truncation of data. 568 C180 
bit A170 words 

the GET command is utilized to 
56 €180 data bits per 60 bit 
to NOS/VE as a 64 bit oriented 


oo eG a 4S OO 


ee 
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~@ REPLACE cannot be used to reptace an existing A170 File 

o GET and REPLACE do not allow specification of alternate user 
namese Use of multipte LIU commands with different families for 
each user catalog is a way to circumvent this restriction. 

o An asterisk should be temporariity used in place of the quote 
marke 

o An ad character should be temporarily used in place of the 
underline. 


E3e50e22821 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT GON A170 NOS 
Notes 


o CLGO170 is A170 permanent file name for file containing object 
text tin CI data mapping) for modules to be included in the 
library. | } 7 

o CITEXT180 is NOS/VE local file name for File containing object 
text (in CI data mapping) for modules to be included in the 
library. 

o TITEXT1L8CO is NOS/VE local file name for file containing object 
text (in II data mapping) for modules to be included in the 


library. 

0 LIBRARY180 is NOS/VE tocai file name for the library being 
created. 

o ILIB170 is A170 permanent file name for file containing the 
library. 


NOS/7VE Job Commands 


sci 

LIUs USER#(jinaNVE doa 
PASSWORD= jinxs.- 
ACCOUNT=notusedysee 
PROJECT=notused 

HCS 


GET»scitext180sclg0170» s»sNVEsB60 
EXsCITOLIs*citextl80,i itext138o* 
EXsCOL 

ADDs OBJECT_FILE=ii text180 

GENERATE sLIBRARY=library180 

END 
REPLACEstibraryl80si1ib1l709»5 sNVEsB56 
JMEXIT 


£3050208.2 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 


he 


Notes 
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o ILIB170 is A170 permanent file name for file containg the old 
library 

o LIBRARY180 is NOS/VE tocal file name for file containing the ofd 
tibrary 

o CMOD170 is A170 permanent file name for file containing CI 
object text for the new module 

o NEWCIMOGDULE is NOS/VE itocal file name for file containing CI 
object text for the new module 

o NEWIIMODULE is NOS/VE !tocal file name for file containing II 
object text for the new module 

o NEWLIBRARY is NOS/VE local file name for the library being 
created 

NLIB170 is A170 tocal file name for new library 


NOS/VE Job Commands 


SCL 
LIUsUSR=(jin»sNVE) »e-4 
PASSWORD=jinxses 
ACCOUNT=notuseds.-~ 
PROJECT=notusedse. 
HCS 


GETstlibraryl8O0silibl70s»s»NVEsB56 
GET» newcimodul es cmod170sa»NVE»s B60 
EXsCITOILIs *newcimodulesneniimodule! 
EXsCOL 

ADDstlibrary=library180_ . 
REPLACEsOBJECT_FILE=newiimodute 
GENERATE sLIBRARY*newlibrary 

END 
REPLACEsnewlibrarysntibl709»ss.NVEsB56 
JMEXIT 


£3050208e3 USAGE OF NOS/VE LOADER 
LIMITATIONS | 


The NOS/VE toader is activated by the HCS version of the EXECUTE 
command. This causes some limitations to loader usage since the 
HCS version of EXECUTE does not support all of the parameters 
{loader options in particular) that the NOS/VE version supports. 
These limitations are detailed below? 


- Exactly one file must be specified in the object list. This 
File must be an object text file (as opposed to a tibrary 
file). 


~ Modules are loaded from libraries onty to satisfy externals. 
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—- 


Libraries to be used for this purpose may be specified by either 


the (SCL) command SET_LOBJECT_LIST or directives embedded in 
object text being loaded. The Jibrary of task services entry 
points is glways used to satisfy externals. 


At teast one module to be loaded must contain a CYBIL PROGRAM or 
the equivalent (i.e.s a transfer symbo! must be specified). 


Load map options Bs E and S are selected by defauit.e These 
selections may be changed via the (SCL) command 
SET_PROGRAM_OPTIONS. 


The default error action is ERROR. This selection may be 
changed via the (SCL) command SET_.PROGRAM_OPTIONS. 


The toad map is always generated on the NOS/VE file named 
tloadmap*, 


The program options STACK SIZE AND PRESET are not supported. 


PROCESS 


Create an object text file by compiling a program in real state. 
Then perform the following steps in virtual state: 


Use the (SCL) command SET_LOQBJECT_LLIST to specify necessary 
libraries which are not quoted in text embedded directives. 


Acquire any necessary tibraries by either: 


o Creating the library file via the object library generator 

or 

o Staging the tibrary file from reali state to vitual state 
using the (HCS) command GET (with B56 conversion mode 
specified). 


Stage the object text file from reai state to virtual state 
using the (HCS) command GET (with 860 conversion mode 
specified). 


Convert the object text file from the CI data mapping to II data 
mapping by executing the HCS program CITOII. 


Load and execute the program via the (HCS) command EXECUTE. 


Stage the loadmap from virtuadl state to real state (for 
Printing) by using either: 
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o The (HCS) command REPLACE (with A& conversion mode 
specified) if running on the simulator. 

or 

o The (HCS) command JMROUTE if running on the hardware. 


EXAMPLES 


The following is an example command sequence for executing a 
program not requiring any tibraries for loading? 


Assumptions: ali modules to be loaded are contained on the (real 
state) permanent file 'citxtrs'. 


SCL 
LINK_USERsUSER=( jing NVE) sPASSWORD=jinxs.. 
ACCOUNT=notused»sPROJEC T=notused 
HCS 
GETscitxtysscitxtrssssNVEs B60 
EXECUTEsCITOUIs'citxtvssiitext! 
EXECUTEs,iitext,stprogram parameters? 
JMROUTE snotusedsLDADMAPsPR»sREMOTE 


The following is an exampie command sequence for executing a 
program requiring libraries for loading: 


Assumptions: the (real state) permanent file 'citxtrs* contains 
object text generated by the CYBIL CI compifler. The compiter 
modules reference procedures contained on the user tlibrary ‘mylib? 
and the CYBIL run-time library. These libraries have been 
generated in virtual state and saved in rea state. 


SCL 

LINK_USER»sUSER=(DEV1»sDEVIF )»PASSWORD=DEVIXe. 
ACCOUNT=notused,s PROJECT=notused 

LINK_USERsUSER#®( jinsNVE) sPASSWORD® jinxs. 
ACCOUNT=notusedsPROJEC T=notused 

SET_OBJECT_LISTs,aDD=my lib 

SET. PROGRAM_OPTIONS » MAP_LOPTIGNS=(BsEsX 93S) 

HCS 

GETsCYBILIBsCYBIILBs »»DEVIF,sB56 

GET» mlibsmyl ibs»»NVE»B 56 

GEtscitxtvsscitxtrsss»NVE» B60 

EXECUTEsCITOLI s*citxtvss,iitext? 

EXECUTEsiitext»s'program parameters’ 

JUMROUTEsnotusedslLOADMAPsPRsREMOTE 
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£3252228.4 CYBIL RUNTIME 


The CYBIL runtime procedure can be obtained via the following? 


GETsCYBILIBsCYBILIBs»DEVI»NVE» B56 


E305022¢825 PERMANENT FILE PROGRAM INTERFACE BUILD J DEFICIENCIES 


1) 


2) 


3) 


4) 


5) 


6) 


7) 


Since no validation facility exists at build J» there is no 
official way for a 180 user's master catalog to be created. 
Without a master catalogs» it is impossibie to use NOS/VE 
permanent file requests aimed at "180 side™ permanent files. [It 
is» howevers possible for a 180 job to access 170 permanent: 
files. If anyone requires access to "180 side™ permanent files» 
a job can be provided that will create the required master 
catalogs 


Permanent files on the "180 side" are only permanent until a 
NOS /VE deadstart. 


Usage - selections and share-requiements may be specified on 
the ATTACH request but they will not be honored. Files will 
never appear busy and hence the hotd parameter has no affect on 
the ATTACH or GET requests. 


GET» SAVE and REPLACE are not complietety impiemented at build 
J. In their partial impiementations GET acts tike an ATTACH 
(ie@e» no file copy occurs)}3 SAVE acts fike a DEFINE but 
requires that the focal file already exist; REPLACE acts like a 
DEFINE but requies that the focal file already exist and will 
replace the specified cycie if it already exists. This means 
that a file that is already a permanent File (via DEFINE, SAVE- 
or REPLACE) may not be saved or replaced. 


Until build K it will not be possible to purge or reptace a 
"180 side" permanent fie if it Is attached by any jobs including 
the one doing the purge or replace. 


Permanent files are never purged because a retention period has 
expireds 


Oniy cycite permission is required to replace a "180 side*™ 
permanent file. 
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verermav 


£326 NOS/VE_IERMINATION 


Type 


Ks»*BYEVE. 


E3.7 DSDI INFORMATION 


To create an Express Deadstart Dump (EDD) tape: 


1) 
2) 
3) 
4) 
5) 


6) 


7) 
8) 


9) 


10) 


Mount scratch tape (ring in) on a 9-track drive. 


Push D#S button. 

Sefect U (utilities) display. 
Select E (EDD) display. 

Set channel ($212). 

Set ECUU (S$2201uu) 

—E = equipment 


C = 1 for 67X drives 
2 for 66X drives 


uu = unit number of the tape drive to be 
Answer "non zero inhibits rewind” with a 
Answer “dump number™ with a CRe 


Answer “"CM/(MB)" with the size of memory 
(in megabytes). 


usede 


CR. 


you want to dump 


Note: This dispitay may not appears depending on the version 


of £EDD being used. 


Answer "dump controlware™ with a CR. 


To create a listing of the €DD tapes 


1) 


2) 


REQUESTsDUMP sNT»D=PEsF=SslLB=KU»sPO=ReVSNeyour choice. 


GETsDSDI/UN=BRH. (On S/N 101.) 
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or 
GET,» DSDI/UN=LIBRARY. (On $2.2) 
3) Create DSDI directives file: 
A DSDI directive file should include the following: 
IGUMR. 
PROMR., 
MEMMR. 
PRORF. 
Ws first _byte_addressslast_byte_adresssasid. (where the 
first byte_address and tast_byte_address are hex byte 
addresses and asid is the asid of the segment to be dumped) 


4) Execute DSDI: 


RFiL»60000. 
DSDI»MsDsI="input directives file". 


5) Torun (after the first time): 
DSDIsT=ne 
{Does not read tape again.) 
6) To run interactively: 
Same as aboves except to do W command must first do 
DUTPUTsLISTFIL. 


7) €170 DOSDI information can be found in Chapter 10 of the NOS 
SYSTEM MAINTENANCE Manual. 


A170 DSDI info can be found in document ARH3060 —— GID for 
A170 NOS/S2. 


£3.38 NAMITAE_INEORNATION 


Bringing NAM up. 


1) To run NAMIAFs the 2550 in the northeast corner of the fishbow! 
is used. CLA*s 10,59 lls 12 and 13 in the middie cabinet must be 
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turned of fs and the CLAts in the right hand cabinet must be 
one The teletype beside the 2550 must be ON and turned to 
LINE. 


2) At the system console enter: 
FNC5s7700. | 
2eNAMs 


3) If IAF is not up at control point ls» enters 
IAF. 


4) To send messages to ail terminals enter: 
2eCFOeMSGsALL»amessage.e 


Bringing NAM down. 


1} At the system consoles enter: 
2eCFO.DIaNE. 


2) Turn the tetetype by the 2550 off. 


3) To bring IAF down enter: 
1-STOP. 


E329 Al7O NOS _SHUTOOWN 


Before ieaving the machines it is necessary to bring NOS down. 
If NOS has crasheds a tlevel 3 deadstart must be attempted {see 
Section 3.1.8) even if the only reason is to bring NOS downe To 
bring NOS downs do the following: 


1) Enter: 


CHE 

The screen will display: 
CHECKPOINT SYSTEM. 
Enter: carriage return 


2) Make sure no mass storage device has a checkpoint rquested. To 
do this» enter: EsM. If the disptiay shows there are no "C"s jin 
the status fields then all devices are checkpointed and you may 
continue. 


3) Enter? 
STEP. 
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4) Push deadstart button. 


E3e10 INTERIM MEMORY LINK STORAGE MOVE CONSIDERATIONS 


The following precautions must be taken when running dual state 
with the Interim Memory Link storage move fix {NOS/VE Build J6 and 
associated NOS/A170 System). 


1) Drop IRHF170» PASSON and alf’ permanent file partner jobs before 
doing *BYEVE. 


2) Do not roltfliout IRHF170» PASSON or permanent file partner jobs 
at any time. 


3) Before doing a CHECKPOINT SYSTEMs drop IRHF170» PASSON and all 
permanent File partner jobs. 


4) If the system crashes a NOS/A170 level 3 deadstart is the 
preferred action. If for some reason you must do an MCU 
recovery (REC command) do the following: 


Ciear word 1718) via: 

99-6 

1790. 
Enter REC on the MCU console. 
Finish up in A170 onty mode (i.e.es do not do an UPMYVE)>» 
then do a tevel 3 deadstart. If you bring up NOS/VE again 
without doing a level 3 deadstarts the results are 
unpredictable. 


E3-11 NOSAVE_ INTERACTIVE FACILITY OPERATION 


E3211-1 GPERATOR INITIATION 


To bring up the NOS/VE interactive facility do the following: 


1) Bring up NOS/VE (build J7 or tater). 


2) Bring up NOS/A170 networks? 


FNC5s7700. (may sometimes be skipped) 


oe 
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1 OPERATOR INITIATION 


3) 


4) 


5) 


E3. 


—m PDaNAMs 
Bring up A170 part of interactive: 
—-  XePASSON (CAT=nnn) 


Where nnn is Cusuatiy) the same catalog that was specified 
on the X.UPMYVE in step 1. 


When NOS/VE Is ues bring up the C180 part of interactive: 
— KeEX ITFEXECssA. 


Bring up the remote host (IRHF170»RHINPUTsRHOUT4S) if desired. 
11.22 GPERATOR TERMINATION 


To terminate NOS/VE interactive any of the following may be 


done: 


E3-~ 


2eCFO.DIsAP2TAF. (2 is the NAM control point number) 


This is the preferred method. To bring NOS/VE Interactive back 
ups you must first do a 2.-CFOeEN»s AP=TAF. 


2eCFO~DIsNEe (2 is the NAM control point number) 
This terminates the entire network including IAFsRBFs etc. 
NeDROP. (Cand) K~TMTERM TFEXEC. (N is the PASSON controt point 
number) 
1123 OTHER OPERATOR CAPABILITIES 
To send a “shutdown warning™ to all terminaits togged on to TAF 
do: 

2eCFO.~IDsAP2=TAF. (2 is the NAM control point number) 
To send a message to aff terminats do? 


2eCFOsMSGsALL»mesagee {2 is the NAM control point number) 
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~ PASSON has the ability to record various types of diagnostic 
information. This capability is controlied via the sense 


switches at the PASSON control point. To turn a sense switch on. 


{off) at contro! point N do3 
Ne»GNSWXe (N»ADFFSWX.) 


Where X is the desired sense switch {1 to 6}2 The PASSON 
default is all sense switches off. It will take a short period 
of time before PASSON detects a change in a sense switch and 
reacts to it. The sense switches currently used by PASSON are?. 


switch #_ use 
i Network Trace 
2 PASSON Logic Trace To Dayfile 
3 Memory Link Trace To Dayfile 


E3.21124 INTERACTIVE TERMINAL OPERATION 


E3211.4.1 Validation To Access NOS/VE 


To access NOS/VE via the interactive facilitys your user number 
must be validated to logon to the application named TAF. If you 
get the message "ILLEGAL APPLICATION! when trying to fogons you are 
probably not validated to access TAF. To correct this do the 
following from the console? 


X2MODVAL. 


KaNe (N is the MODVAL control point number) 
KeUsccce (ccc is your user number) 
KeAP#ALL. 

Ke ENDs 

KeEND= 


If you get the message "CONNECTION PROHIBITED* it means that 
oniy one terminal per user number can be togged on to TAF at one 
times This indicates that someone has changed the network 
configuration ~- try a different user number until the network 
configuration is changed. 
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£3211.4.2 Login To NOS/VE 


To initially login to NOS/VE via TAFs you must cause the first 
logon attempt to fail. This can be done by responding to the 
"FAMILY?" logon prompt with something Fike? "AsAxsA". This must be 
done because the system will try to connect the terminal to IAF on 
the first logon attempt no matter what is typed. To access TAF do 
the following on the second "FAMILY:" prompt? 


suserspasswor ds TAF 


You can access TAF from IAF by doing “"HELULOsTAF" or by answering 
TAF to the system prompt "APPLICATION: ®, 


When the terminal has been successfully logged in to NOS/VE>» the 


following message wil! be dispiayed at the termina: 
Welcome to NOS/VE Interactive On The $2. 


£3.11.4.3 [erminal Usage 


1) The stash (/) is a prompt to enter a NOS/VE commands. Any 
normat NOS/VE command can now be entered. The full ASCII 
character set (lower or upper case and alf special characters 
can be used). Commands do not need to be ended with a period. 


2) A JMEXIT command will cause the NOS/VE Interactive Job to 
terminate and it's dayfilte (job tog) wiit be returned to the 
A170 for printing. A new NOS/VE Interactive Job can then be 
started by responding to the "APPLICATION: * prompt with TAF. 


3) A Terminal Break (Control! T) can be used to discard output from. 


a NOS/VE command. A Terminal Break will not terminate a NOS/VE 
user task (ieees a task initiated with the EX command) or cause 
it's output to be discarded. An asynchronous (A parameter on 
EX command) NOS/VE user task can be terminated with a TMTERM 
XXX command (XXX is the user task name as specified on the EX 
command). A synchronous NOS/VE task or any NOS/VE task waiting 
for input from the terminal cannot be terminated either by a 
Terminal Break or a TMTERM command. 


E3.11.404 NOSZVE Program Access To The Terminal 


1) Interactive NOS/VE jobs are able to obtain terminal input 
through the CLPSGET_STND_INP program interface which can be 
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2) 


used by both task services and user ring programs. Interactive 


programs which use this interface should be abte to handte both. 


upper and lower case input in order to make them more 
convenient to use in both 64 and 96 character set modes. 


Interactive NOS/VE jobs can send output to a terminal through 
the CLPSPUT_LSTND_OUT program interface which can be used by 
both task services and user ring programs. This interface will 
cause the terminal to operate in ‘no Format effector® mode 
(i.@. pre and post print format effectors should not be used - 
each CLPSPUT_STND_OUT call will start a new tine). 
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F400 32. DEVELOPMENT LAB SUPPORT BY_ INTEGRATION 


What we have established in the tab so far is the following? 


A 600 tape capacity tape rack for general use (ltocated in near 


proximity to the 67X tape drives).j If your project woutd like 
to reserve a section of this tape racks, contact Tim or myself. 


A tape and disk cabinet for storage of system support materials 


which this project will manage and keep up to date. {If you 


have been using this cabinet for unauthorized storage —- 


beware. We have the key to the fock!) More wili be published 
about the contents of this cabinet iaters and a cabinet index 
will be posted in the lab to help locate where things are 
supposed to be placed within the cabinete This cabinet is 
currentiy tocated against th East wail of the labs is 6 ft. 8 
ine talls gray in color and with sliding door. 


A two-level documentation rack for system documentation 


listings. This contains the current buitd compilation tisting 
interface deck compilation tisting (from module named QLNGS)>» 
fisting of the NOS/VE PPU routiness system link maps and 
various assorted PVE fistingse This rack is next to the tape 
and disk cabinet at this time. 


A desk documentation rack for reference manuais and Tom McGee's 


collection of “how to" goodies. The objective is to have this 


reference information at arm's ftength of the consoles but it is 


currently on top of the two-level unit by the East walt. 


At or near the console is a smal! notebook containing the NOS 


System Programmer's Instants NOS Application Programmer's 
Instants and the 180 Instruction codes. 


Feel free to examine and use all of the above materials while in 
the lab. Do not remove or abuse any of these materialss. Please 
notify Tim McGibbon or Mike Carter of any problems or deficiencies 
of these matertats. Leave a note if we are not available. 
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APPENDIX A_NOS/VE_ BACKGROUND DOCUMENTS 


1.0 Hardware Overview 


1.1 An introduction to CYBER 180 


1.22 C€i80 Instant 


1.3 Mode! Independent General Design Specification - ARH1700 


220 NOS Reference Manuals 


201 XEDIT V3.0 — 60455730 


202 IAF 
223 NOS 
2.4 NOS 
225 NOS 
226 NOS 
207 NOS 
2.8 NOS 

320 NOS/VE 


V1.0 User*s Guide — 60455260 

Reference Manual — Vol 1» 60435400 — Vol 2» 60445300 
Instant 

Operators Guide - 60435600 

Diagnostic Handbook 

A170 ERS 


A170 GID — ARH3060 


Reference Documents 


321 Program Interface ERS — obtained from Karen Rubey 


322 Command Interface ERS — obtained from Karen Rubey 


3.3 NOS/VE User's Guide —- obtained by the following? 
ATTACHsHUG/UN=DAH 


SES. 
SES. 


FORMAT IT=HUGsL=LIST»LOCAL» TXTFORM 
PRINT LIST 


3.24 NOS/VE Procedures and Conventions ~ obtained by 
SESsMADeLISTPC 
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325 JFS Deadstart/180 Operating Procedures 

3e6 Listing of all NGS/VE Modules —- obtained by 
SESsDEVIL.~LISTNVE. See Integration Procedures Notebook for 
details. 


327 Listing of all NOS/VE type dectarations — obtained by 
doings SESsDEVI»aLISTNVE M=QLNOS. 


328 NOS/VE Code Transmittal/PL Maintenance Procedures 
See Integration Procedures Notebook. 

329 NOS/VE Internal Interface Maintenance Procedures 
Memo available from S.C. Wood. 

3.10 Integration Procedures Notebook 
Obtained by: 


Acquires IPNDOC2/UN=MDC. SES»PRINTs»IPNDOC2. 


4.0 Tools Reference Documents 
4e1 PASCAL~-X Interactive Debugger ~ ARH3142 
4e2 SES User's Guide —- ARH1833 
43 PASCAL—X Specification — ARH2298 
404 C180 Assembler ERS ~— ARH1693 
4.5 Simulator ERS ~— ARH1729 
426 VEGEN ERS ~ ARH2591 
4.7 VELINK ERS — ARH2816 
4.8 Simulated 1/0 ERS — ARH3125 
4.9 Object Code Utilities ERS — ARH2922 


4210 CYBIL Implementation Dependent Handbook — ARH3078 
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5.0 Dual State Cookbook 


To acquire additional copies of this document enter: 


ACQUIRE DOCUMEN/UN=SKT512 
SES.~FORMAT I2DOCUMEN TXTFORM. 
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F1.0 INTRODUCTION 


Fl.1 PURPOSE 


The purpose of this document is to give an overview of the 
NOS/JVE system (formerty called HCS) from the following. 
perspectives: 


—~ Adding user tasks (tests) 

~ Modifying NOS/VE components 

— Adding new NOS/VE components 

—~ System usage - hardware and simulator 
~ Hints 


anu 
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F2.0 ADDING USER TASKS TO _NOS/VE 


F2.e.001 INTRODUCTION 


A user task can be defined as a group of modules tinked 
together that will execute in the fuser ring’ of NOS/VEs 
currentiy ring 11. This task may make calis to any gated entries 
within task services (rings 1 through 3) if the call bracket wilt 


allow the cali. Data defined within task services may not be. 


referenced from rings 4-15. 
F220e2 USING THE VE LINKER 


The general format of the LINK command is? 
SES. VELINK LFL=CYBILIB LPF*LIBLCB OFL=LGO NS=LIBX 


The LPF parameter specifies the file containing Virtual 
Environment Linker variables that control the tinkage. If the 
LPF parameter is not specifieds these variables default to values 
provided by the VELINK procedure. The vaiues for both the LFL 
and BFL parameters may be anything the user requires ~- it is 
these parameter that define the makeup of a given user taske The 
VE Linker ERS shoutd be consulted for a detailed description of 
the avaitable parameters. 


Every LINK command creates one unique user taske The vatue 
for the NS parameter must be unique among atl user tasks in a 
given virtual environment build. The value given must be 4 
characters and cannot be either MTRX or STSX» as these vatues are 
used for monitor and task services. 


The following exampte should help to clarify how to make _ the 
modifications. Suppose we want to create two user tasks. fhe 
first requires object files A and B from the current users 
catatog and faite CC from catalog INT2. The second task requires 
object Files D and E from the current catalog and Jlibrary file 
Lie The necessary commands are? 


ACQUIRE sCC/UNZINT2Z 
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SES»VELINK LFL=CYBILIB LPF*LIBLCB OFL=(A»BsCC) NS*LIBX 
SESsVELINK LFL=(L1isCYBILIB) LPF=LIBLCB OFL=(D,E) .. 
NS=LIBZ 


There are five things to note about this example: 


1) The use of multiple vaiues with the LFL and OFL parameters (Cup 
to 10). 

2) The fact that local files are referenced first by the tinker 
before they are searched for in the user's catalog. 

3) The use of a continuation (e..) cards 

4) The unique NS values LIBX and LIBZ. 

5) The assumption that CYBILIB exists in the current catalogs or 

is already local to the job. If neither of these cases is trues 

then CYBILIB must be ACQUIRE'd from the catalog which contains 

the desired version. The same assumption holds for LIBLCB. 


The changes to be to the VELDCM file are descrihed betow. 
Immediately after the directives: 


LOADJOB STSX 
directives of the format: 
LOADLIB NS PNAME 


Should be  ptaced. There should be one directive per user task 
{i.2@., one per user task LINK command in the VELDCM file). The 
NS parameter value must be the same as the value specified for 
the NS parameter on the LINK command. The value for PNAME may be 
any one to eight character name and is the name of this *program*® 
when it resides on the NOS/VE *library!. 


It is important to note that all code and data must fit into 
reali memory at the time of loading and deadstart. The simulator 
imposes a 500K (16M with next release) byte restriction on 
maximum size and the hardware is restricted to 2M bytes. If the 
memory required exceeds the default maximum of 7A000 (16) bytes» 
then the VELDCM file must be changed to reflect this. The size 
of the page table must be increased so that it has 2 to 4 times 
as many entries as the number of real memory pages. The page 
table size is changed in the VELDCM file in three different 


places» however» it is not just a simple substitution. 
Assistance should be obtained when any VELDCM file modifications 
are required. The following diagram shows the virtual 


environment after loading: 
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Using the exampie from aboves the two directives to be added 
to the VELDCM file are: 


LOADLIB LIBX PROGA 
LOADLIB LIBZ PROGB 


The names PROGA and PROGB can be whatever is desireds but must 
be unique within a singie NOS/VE build. 


To execute PROGA»s the following NGS/VE command is used: 
EXEC PROGA 'string! 


One final note about the VELDCM file. Qne of the ftast 
commands is a *DM ALL® command which produces a hex dump of the 
virtual environment file. This command may be removed if the 
dump is not wanted. 


When using the VE Linker specifically to produce NOS/VE 
systems it is recommended that the procedure NOSLINK»s as 
described in the Advanced Systems Integration Procedures 
Notebooks be used to produce these systems. Use of any other 
procedures may tead to erroneous versions of interrelated 
software components. 
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F320 EXECUTION 


F3.1 INTRODUCTION 


NOS/VE will run on either the C180 hardware or the simuiator. 
Any differences between the two are resolved by NOS/VE itseif or 
by the procedures used to run it. 


NOS/VE provides three different types of commands. The first 
type allows access to most of the software facilities within the 
systems such as? 


Execution Management 
Logical Name Management 
Task Management 

Fite Management 

Segment Management 
Memory Management 

Heap Management 

Signal Management 


The second type provides a debugging capability to be used. 
within an executing task. The features avaitable are: 


Breakpoint 

Trace Back 

Register Manipulation 
Memory Manipulation 


Both of the first two types are availabie on both the hardware 
and the simulator. The third type of command is availtabie oaonty 
on the hardware. These commands are processed by the PPU console 
drivers and offer the following features: 


Memory Manipulation 
Register Manipulation 
Print Memory 

OS Disptays (Dayfiie) 


NOS/VE currently supports a singie job and multipie tasks 
within that job. A task may be executed synchronously or 
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F321 INTRODUCTION 


asynchronously with other tasks. 


F322 NOS/VE_ COMMANDS 


~NOS/VE commands allow the user access to a targe number of 


functions provided by the system. In generals» any parameter to. 


one of these commands may be either an explicit value or a 
logical name space {LNS) variable. Qne exception to this is the 
use of task status blocks or signal controf blockss which must 
always be LNS variables. A logical name space is associated with 
a jobs a fact which must be considered when running multiple 
tasks. 


The following types of LLNS variables and parameters are 
availabie: 


INTEGER 

CHARACTER 

NAME 

BOGLEAN 

VSTRING 

POINTER 

SIGNAL CONTROL BLOCK (temporary for HCS oniy) 
TASK STATUS BLOCKS 


Within the descriptions which follows optional parameters are 
enciosed in square brackets ((€]). 
F322e1 DECLARE 
This command is used to create variables within the logical 
name space of the current job» 
Syntax: DECLARE NAME TYPE 
NAME ~ LNS variable names 1 to 31 characterse 
TYPE — Variable types must be one of the foltowing: 
INTEGER ~- A 64 bit integer. 
BOGLEAN - The vatue TRUE or FALSE. 
POINTER —- A pointer to cell. 


$CB - <A signal control block. 
VSTRING A STRING (*) variable. 


i 
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CHARACTER — A single character. 
TSB ~ A task status blocke 


F3.222 REMOVE 
This command is used to remove a variable definition from. the 
logical name space of the current job. 


Syntax: REMOVE NAME 


NAME ~- LNS variabfe names 1 to 31 characters. 


F3e2223 PFSTATS 


This command is used to display the following page fault 
statistics: 


avail q —- Number of times a page was found in the 
available queue. 

avail mod q —- Number of times a page was found in the 
available/modified queue. 


valid in pt — Number of times the page was found in the page 
table. 

no memory ~ Number of times a page fault could not be 
satisfied because no real memory was 
available. 

locked —- Number of times a page fault could not be 


satisfied because the page frame was locked (10 
was active). 

on disk — Number of times a page was found on a diske 

pt full -~ Number of times a page fault could not be 
satisfied because an empty entry could not be 
found in the page tablee 


cio reject —- Number of times a page fault could not be 
satisfied because of an 1/0 error. 
new page —- Number of times that a new page was created. 


syntax: PFSTATS 
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F32224 TSTATUS 
This command is used to display the status of att currently 
active tasks. The following information is displayed? 
Task Name 
Execution Time Used 


Number of page faults 


syntax: TSTATUS 
F32225 TMCYCLE 


This command causes a task to give up its turn for execution 
until all other ready tasks have had at teast one chance to 
execute. 


syntax: TMCYCLE 
F3.2206 TMDELAY 


This command causes a task to be kept from executing for a 
specified number of mitdiiseconds. 


syntax: TMDELAY MS 


MS — Number of milliseconds to delay. 
F32227 TMABORT 


This command causes the current task to be aborteds 
syntax: TMABORT "MES? 


MES -—- A string to be dispiayed when the task is aborted. 
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F32228 TMEXIT 


F3.2.8 TMEXIT | 


This command causes the current task to terminate normality. 


syntax: 


TMEXIT 


F30e209 EXEC/EX 


This command causes a new task to be created and executed 


subordinate to the current taske 


syntax: 


PROGRAM 


PARAM 


TSB 


EXEC PROGRAM CPARAM] (TSB) 


EX PROGRAM EPARAM] CTSB} 


The name of the program on the system 'library* to be 


executed. 


A string that is 
program header. 


passed to the program via the 


Dne of the following: 


DEBUG = 


Other non-blank —- 


Specifies that the task is to be 
executed by the debug processors 
The task is run synchronousty. 


Specifies that the task should be 
executed asynchronous! ys but 
without any task status biock 
being used. 


Specifies that a etask status 
block variable of the name given 
is to be created in the current 
job's LNS and the new task is to 
be run asynchronousty with the 
current taske The task name in 
this case will be the value given 
for this parameter. The user can 
determine the status of a task by 
printing the vaiue of the task 
status blocke 


If the parameter is omitteds the task will be run 


synchronoustye 


_ F3-6 
NOS/VE USERS GUIDE 
09/17/80 


F320 EXECUTION 
F322210 TMTERM 


F322.210 TMTERM 


This command is used to terminate a specific task and ail 
callees of that task. 


syntax: TMTERM TASKNAME 


TASKNAME — The name of the task to terminate. 
F3e2e11 SMOPEN 


This command causes a segment access open to be performed on a 
local files, or causes a transient segment to be created. 


Syntax: SMOPEN PVA CNAME} ECSEGNUM] CR1] C€R21 CATTRI 


PVA at The name of an LUNS'~ pointer variabie to receive the 
segment pointer. 


NAME - The name of the local File (1 to 8 characters) to open. 
as a segment. If this parameter is omitteds a transient 
segment is created. ; 


SEGNUM—- The segment number to be assigned to the segment. If 
this parameter is omitteds an unused segment number witi 
be chosen. 


R1 '—~- The Ri value for the segment. If this parameter is 
omitteds 11 is used, 


R1 - The R2 vatue for the segment. If this parameter is 
omitteds 11 is used. 


ATTR -— The attributes of the segment. A legal vatue is any 
valid combination of the following tetters: 


- Read 

~ Write 

- Execute 

- Binding 

~ Execute Local Privitege 
~ Execute Global Privilege 
- Wired 

- Stack 

—- Cache Bypass 
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S ~ Shared 
Q —- Sequentiai Access 


The default is RW. 

F3.2212 SMCLOSE 

This command causes a segment of the current task to be 
removed from that task's address space. 
syntax: SMCLOSE PVA 
PVA — A pointer to a cell. The segment represented by this 

pointer will be closed. 

F322e013 SMCHANGE 

This command altows some of a segments attributes to be 
changed after it has been created. 
syntax? SMCHANGE PVA [R1] £R2] CATTR] 
PVA —~ Same definition as SMOPEN 
Rl ~ Same definition as SMGPEN 
R2 — Same definition as SMOPEN 


ATTR —- Same definition as SMOPEN. 
F322014 MMADVI 


This command causes the system to be notified that the 
specified range of virtual memory should be paged in as soon as 
possible. 
syntax? MMADVI CPVA] [LEN] 


PVA —- A pointer to the first byte of virtual memory to be paged 
ine The default is NIL. 


LEN ~ The number of bytes to page ine The default is 1. 
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F3.22215 MMADVG 
This command notifies the system that the specified range of 
virtual memory may be paged out (removed from the working set). 
syntax? MMADVO [PVA] CLEN] 
PVA — Same as in MMADVI»s except that memory is paged out. 
LEN — Same as in MMADVI,s except that memory is paged oute 
F3e2e16 MMADVOI 
This command performs the functions of both the MMADVO and 
MMADVI commandse The page out is performed first. 
syntax? MMADVO CPVAOD] [LENO] CPVAI] CLENI] 
PVAD — Same as in MMADVO. 
LENO -—- Same as in MMADVO. 
PVAI =~ Same as in MMADVI. 


LENI ~- Same as in MMADVI. 


F3e2e17 MMWMP 


This command is similar to the MMADVO command except that the. 


pages are written to disk immediatly. 

syntax: MMWMP CPVA] [LEN] (CWAIT] 

PVA — Same as MMADVO. 

LEN ~ Same as MMADVO. 

WATT - The value TRUE if the user desires to wait untii = ali 


paging I/0. is completes otherwise FALSE. The defauit is 
TRUE. 
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F3e2218 


This 


MMFREE 


command causes the pages representing the specified range 


of virtual memory to be released. 


syntax: 


MMFREE PVA [LEN] 


PVA ~- same as in MMADVI. 


LEN ~ same as in MMADVI. 


F3e2e19 


This 


CONPVA 


command converts a process virtual address (PVA) to a 


real memory address (RMA). 


syntax. 


CONPVA PVA (CMODE] 


PVA —- The pointer to be converted to an RMA. 


MODE —- One of the following values: 


F302220 


This 
syntax: 


HEAPP — 


DIRECT ~ The specified PVA is to be converted. This is 
the default vatue. 


INDIR -— The specified PVA is a pointer to the PVA to be 
converted. 


HPINIT 


command causes a heap to be created and initialized. 
HPINIT HEAPP LEN 


The name of an LNS pointer variabie. It wil! be set to 
point to the heap. 


LEN — The length of the heap in bytes. 
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F3.2221 HPALLOC 

This command attecates space within a previously created 
heape 
syntax: HPALLOC PTR LEN CPAGECROS] [ZERO] HEAPP 


PTR —- The name of an tNS pointer variabite. It wilt be set to. 
point to the allocated area. 


LEN —- The number of bytes to allocate. 


PAGECROS— This parameter has no affect. It is inctuded for 
compatibility. 


ZERO —- The value TRUE if the allocated area is to be preset to 
the value zero or FALSE if it is to be teft as is. 
The default is FALSE. 

HEAPP - A pointer to the heap in which the space is to be 
atlocated. 

F3e2e22 HPFREE 

This command frees a block of space previously altocated from 
a heap. 


syntax: HPFREE PTR HEAPP 


PTR - The name of an LtNS pointer variable which points to the 
biock to be freed. 


HEAPP— A pointer to the heap in which the block is allocated. 
F3e2e223 SHINIT 


This command is used to initialize a signai contro! bliock. 
syntax: SHINIT SCB CTYPE] CVSTRI 


SCB -— The name of an LNS signal contro! block variable to be 
initialized. 
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TYPE — The signal type to be associated with the SCB. Must be 
one of the following? 


EVENT 
SEME 
IDRESP 
MESSAGE 


VSTR - If TYPE is messages then this parameter specifies a string 
variable whose size is the maximum message size allowed 


when using this SCBs and whose location is where the data 
will be piaced. 


F3.2224 SHSEND 

This command causes a send signal operation to be performed on 
the specified signai controt biocke 
syntax: SHSEND SCB CLINT] C#*STR*#] 


SCB - The LNS signal contro! biock variabie to which the signal 
is sent. 


INT - Integer value to be sent with the signal 
STR -— A string (in quotes) to be sent as data atong with the 


Signal. If both INT and STR are specified», STR takes 
precedence. 


F3.2e25 SHWAIT 


This command causes the current task to wait until a specified 
amount of time has passed» or until any of up to three signals 
are sente 


syntax? SHWAIT CITIME] CSCB1)] CSCB2) (5CB83) 


ITIME- The number of milliseconds to wait. If this parameter is 
omitted, infinity is used.s 
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SCBi —- Up to three LNS signal control block variables to wait for 
a signal on. 


F3e2e26 CHANGE LNS VALUE 


This command attows the value of an tLNS variabte to be 
changed. Signal control biock and task status biock variables 
cannot be changed. 
syntax: LNSN = NY 
LNSN ~- The name of the LNS variable to be changed. 


NY ~ The new value. 
£3.22.27 PRINT LNS VALUE 

This command causes the value of an UNS variable to be 
displayed. 


syntax: LNSN 


LNSN - The name of the LNS variable to be displayed. 
F322228 ECHOINP 


This command causes alt command input to NOS/VE to be echoed 
back to the output device. This command is useful only when used 
as the first command to a batch mode simulation. 


syntax: ECHOINP 
F3e2229 STOPSIM 
This command causes NOS/VE to stop execution via a CPU halt 


when running on the simulator. 


syntax: STOPSIM 
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F302.230 SSET 


This command allows some of the NOS/VE control parameters to 
be changed dynamically. 


syntax: SSET CPN CNY] 


CPN — The name of the control parameter being changed. The value 
must be one of the following (entries followed by an * are 
not intended for generat use): 


QUANTUM 


MAXIOLE* — 


TICKTIME *— 


DFDELAY* — 


KEYMAX 


STEPCNT# — 


DBRING 


PQTHRESH#— 


KM 


MM 


UM 


Basic task time slice (microseconds) for ail 
tasks created after the execution of this 
commande . 


Maximum amount of time spent in monitor idie 
foop before tooking for ltost interrupts. 


Used for paging control. 


Minimum amount of time between the issuing of 
dayfile messagese Used to slow down the 
scrolling action of the console dayfile 
display. 


Maximum value of the id Field from a keypoint 
that will be placed in the keypoint buffer. 
Any keypoint with an id field greater than 
this vaiue witli be ignored. 


Maximum number of monitor requests ailowed 
before monitor goes inte wait loop. 


Lowest ring that can be executed while in 
debug mode. 


Number of pages kept in the page queues. 


Keypoint mask used for every task created 
after execution of this command. 


Monitor mask used for every task created 
after execution of this command. 


User mask used for every task created after 
execution of this command. 
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PITVAL*® — The vatue that the PIT is reset to after 
every PIT interrupt. 


DISDELAY — How often (milliseconds) the system status 
disptay (3 tines on the console) is updated... 


NV = The new vaiue for the specified controi parameter. If NV 
is omitteds the current value will be displayed. 


It is important to note that these commands are used primarily 


for hardware and monitor debugging and may change or disappear at 
any time. 


F3e2e31 FMCREATE 


This command makes a file known to the system. 
syntax: FMCREATE FILENAME 
FILENAME ~- The name of the file being created (1 to 8 
characters). 
F3e22e32 FMDELETE 
This command detetes a file previousiy made known to the 
system with the FMCREATE command. 
syntax? FMDELETE FILENAME | 
FILENAME — Name of the file being deleted. 
F3.2233 FMDOWNAU 
This command identifies bad areas on disk and keeps them from 
being allocated. 
syntax: FMDOWNAU UNIT CYLINDER TRACK SWLBUG SECTOR 


UNIT - Unit number of the disk device. 


CYLINDER — Cylinder number. 
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TRACK - Track number. 

SWLBUG - This parameter is present because of a compiler 
bug. 

SECTOR - Sector to be marked as bad within the specified 


unit/cyltinder/track. 
F323 CONSOLE COMMANDS 


Commands to the system are entered via the console keyboard. 
With the exception of messages to the operating systems ail 
commands entered must include a two-character command identifier 
or a twoecharacter operating system display identifier. Some 

commands require parameterss others do note Ail command input 
fines are restricted to 60 characters or less3 ail are terminated 
by depressing the carriage return keys 


F3e321 DISPLAY CENTRAL MEMORY 


F3.301.1 Display - Partial Mode 


The following commands provide display of onty the right-—most 
60 bits of central memory words (they use the 60 bit PPU cm 
read/write instructions). 


F3.30elel.1 DP»s<ADDRS> 


Displays an installation-specified number of central memory 
words; two words are displayed per display iine along with the 
byte address of the left-—most word of the tine. 


<addrs>: A 1-8 digit hexadecimal real memory byte address which 
defines the first word to be displayed. The specified 
address is forced to zero module eight if it is not so 
specified by the command. 


F3e3elele2 DP» + 


Increments the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayed. This command is used to "rol!" forward 
through memory. 
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F3.23012123 DP»— 


Decrements the most recently specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayed. This command is used to “rol!l®" backward 
through memory. 


F3e23e1.2124 DP 


This command may be used to reinstate the most recent central 
memory display after the screen thas been used (for other 
purposes. 


F3e3ele2 Display - Full Mode 


The following commands provide dispiay of ail 64 bits of 
central memory words. There are a number of characteristics of 
these commands of which the user should be aware: 


e hese commands use the 64-bit central memory access 
mechanisme 


F30301e201 DF»<ADDRS> 


Displays an install ation-specified number of centrai memory 
words; two words are displayed per display line along with the 
byte address of the left-—most word of the line. 


Caddrs>: A 1-8 digit hexadecimal real _ memory byte address which 
defines the first word to be displayed. The specified 
address is forced to zero module eight if it is note so 
specified by the command. 


F3e3ele2e2 DF» + 


Increments the most recentty specified memory address and 
displays a set of memory words which are contiguous with those 
most recently displayed. This command is used to “roli"™ forward 
through memory. 


F3e3ele223 DF a= 


Decrements the most recentiy specified memory address and 
displays a set of memory words which are contiguous with those 
most recentiy displayed. This command is used to "roti" backward 
through memory. 
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F3e30e10224 DF 


This command may be used to reinstate the most recent central 
memory display after the screen has been used “(for other 
purposese 


F303e2 CHANGE CENTRAL MEMORY 


F3e3e2e1 Change-Partial Mode 


F3e3e2e1.1 CP» <ADDRS>=<VALUE> 


This command inserts a specified value into the right-most 60 
bits of a 64-bit centrai memory word; the teft-most 4 bits of the 
central memory word are unconditionally set to zero. 


€addrs>3 A 1-8 digit hexadecimal rceal memory byte address which 
defines the central memory word which is to be 
modified. The specified address is forced to zero 
module eight If it is not so specified by the command. 


€<value>: A 16 digit hexadecimal vatue which is to be inserted 
into the central memory word; ali 16 digits must be 
specified. Biank characters may separate hex digits if 
desired to simplify value specification; for example, 
the two value specifications shown betow yield the same 
result: 


valuel 0123456789ABCDEF 
value2 0123 4567 89AB CDEF 


F303-202 Change-Full Mode 


F3e230e2e201 CFsas<ADDRS >= <VALUED 


This command inserts a specified value into the full 64 bits 
of a 64-bit centra!) memory word. 


<addrs>: A 1-8 digit hexadecimal real memory byte address which. 
defines the central memory word which is to be 
modified. The specified address is forced to zero 
module eight if it is not so specified by the command. 


<value>: A 16. digit hexadecimal value which is to be inserted 
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into the central memory word; all 16 digits must be 
specified. Biank characters may separate hex digits if 
desired to simplify value specification; for examples 
the two vaiue specifications shown below yield the same 
result: | 


valuel 0123456789ABCDEF 
value2 0123 4567 89AB CDEF 


F3.3.3 PRINT CENTRAL MEMORY 


F3230321 PMs<addrs2e<words2 


This command provides a fisting of central memory to ae “tine 
printer. Four words are Y%isted per tine along with the byte 
address of the teft-most word of the line. 


<addrs>: <A 1-8 digit hexadecimal real memory byte address which 
defines the first central. memory word to be listed. 
The specified address is forced to zero moduie eight if 
it is not so specified by the command. 


<words>2 A 1-5 digit decimal value which specifies the number of 
central memory words to be tisted. 


A listing operation may be terminated prior to its norma! 
comptetion by depressing the carriage return at the keyboard. 


F323.4 DISPLAY/CHANGE SYSTEM ELEMENT REGISTERS 


F3030401 Display Element Registers 


F303 e4elel DR»s<ELID> 


This command causes display of an installation defined set of 
registers of a system element. 


<etid>: <A two-character system element identifier which 
specifies the element of which registers are to be 
displayed. Valid system element identifiers are listed 
under the section entitled "System Element 
Identifiers". The registers dispfayed for each system 
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element are listed under the section entitted "System 
Eiement Registers”. 


F3.3.4.2 Change Element Registers 


F303 040201 CR»e<ELID>» <REGID> =< VALUED 


This command permits modification of system element registers 
for which the maintenance channeid has write access. 


<elidd: A 2 character system element identifier which specifies 
the element of which a register is to be modified. | 
Refer to the section entitied "System Element 
Identifiers" for a tist of valid identifiers. . 


<regid>: <A 1~4 character register identifier which specifies the 
register which is to be modified. Refer to the section 
entitied "System Efement Registers" for a tist of vatid. 
register identifiers for each system element. 


<vaiue>: A 16 digit hexadecimal value which is to be inserted. 


into the register; aii 16 digits must be specified. 
Blank characters may separate hex digits if desired. 


F3.3.4.3 System Element Identifiers 


Following is a tist of valid system element identifiers. 


» M2 Identifies the central memory element 
e P2 Identifies the central processor unit 


F30304e04 System Element Registers 


The following subsections lists according to system elements 
those registers which may be displayed and which may be modified 
(assuming that the maintenance channel has write access to the 
specific register). 


F303 e4%e4el CENTRAL MEMORY REGISTERS 
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REGISTER 
MNEMONIC 
SS 

EC 

BR 

CELO 
UC10 
UC20 


F303 042402 


REGISTER 


(A ea veNED vane vie Rem sg EN 


REGISTER NAME 


Status Summary 

Environment Controf 

Bounds Register 

Corrected Error togs Distributor 0 
Uncorrected Error Log ls Distributor 0 
Uncorrected Error Log 2s Distributor 0 


CENTRAL PROCESSOR REGISTERS 
REGISTER NAME 


Status Summary 

Environment Control 
Program Address 

Monitor Condition Register 
User Condition Register 
Untransiatable Pointer 

Job Process State 
Processor Fault Status 
Retry Corrected Error Log 
Control Memory Corrected Error Log 
Cache Corrected Error Log 
Map Corrected Error Log 
Keypoint Code 

Keypoint Class Number 

Trap Enabtes 

System Interval Timer 
Control! Memory Address 
Control! Memory Breakpoint 
Processor Test Mode 

Model Dependent Word 
Dependent Environment Control 
Maintenance Scan Limit 


F3.3.25 DESPLAY PPS PROGRAM ADDRESS REGISTERS 


ACCESS 
ATTRIBUTES 


Lia a aenieal 


ACCESS 
ATTRIBUTES 


R 
R/W 
RIW 
RIW 

RIW 
R/W 
RIW 
R/W 
RIW 
RéW 
R/W 
R/W 
R/W 
RIW 
R/W 
RIW 
RIW 
R/W 
R/W 
RW 
RIW 
R/W 
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F323050e1 PP 


This command causes dispiay of the program address register of 
each PPU in the PPS. . 


F323e6 CLEAR DISPLAY 
This command is used to deactivate a currentiy active 
display. 
<screen>: Is Ls Rs or B to specify left screens right screens or 
both screenss respectively. 
F3230e7 START SYSTEM 


F3.2327e1 S35 


This command is used during system deadstart after the message 
"PROCEED" is disptayed at the console; this command causes final 
initialization to occur and the CPU to be started. The command 
is valid at no other times 


F32328 HALT CENTRAL PROCESSOR 
F32328e1l HI 
This command is used to hait the central processor. 


F3.23.9 START CENTRAL PROCESSOR 
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F30309s1 GO 


~ 


This command is used to start the central processor after it 
has been halted with the HT command. 


F323210 OPERATING SYSTEM DISPLAYS 


Various operating system displays are availabie to the 
console} a specific display may be called by typing its unique 
2-character identifier and a carriage return. 


F3.3.10.1 Display Identifiers and Descriptions 
DD — Dayfite of the system job. 
F3.23211 CONSOLE MESSAGES TO THE OPERATING SYSTEM. 


Singte tine messages of 60 characters or tess may be sent to 
the operating system From the consofe keyboard, Any tine of 
input from the keyboard is sent to the operating system if both 
of the following conditions are met: 


1. The first two characters of the tine do not match a econsote 
command or an operating system display identifier. 


2e The number of characters in the input tine equals or exceeds 
1 character. 


F3.4 DEBUG FACILITY 


The debug facility of NOS/VE provides a set of capabilities 
intended to assist in testing of programs which execute under 
contro! of NOS/VE. Services provided by the facility are task 
oriented: selection of the debug facility is at the option of the 
user at the time of task invocation. NOS/VE uses the CYBER 180 
debug hardware to provide these capabilities. 
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F3.4.1 SUMMARY OF DEBUG FACILITY SERVICES 


Set Breakpoint: 


Remove Breakpoint: 


Change Breakpoint: 


List Breakpoint: 


Trace Back? 


Dispiay Stack Frame: 


Display Register: 


Change Register: 


Display Memory? 


Change Memory: 


Run: 


Selects a program interrupt which is to 
occur upon occurrence of a specified 
condition within a specified virtual 
address ranges 


Deselects a previously selected program 
interrupt. 


Changes the virtual address range of a 
previously specified breakpoint. 


Provides a list of currentiy selected 
breakpoints and associated conditions.» 


Provides information relevant to stack. 
frames associated with an interrupted 
procedure and its predecessor 
procedurese 


Display selected information from a 
specified stack frame. 


Display the contents of a specified 
register of an interrupted procedure. 


Sets a specified value into a specified 
register of an interrupted procedures 


Displays the contents of a specified area 
of virtual memory. 


Sets a specified value into a specified 
location of virtual memory. 


Invokes program execution after a 
setected procram interrupt has occurred. 


F#3.%.2 DEBUG FACILITY COMMANDS 
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F3.24.22.1 Parameter Definitions 


<name> 232 1-8 character breakpoint name 

<condition> 23= READS WRITESRNIBRANCHS CALLS DIVFLT$ ARLOS: 
AROVFLIEXOVFEL: EXUNFLSFPLOS? FPINDEF $ INVBDP 

<base> 3:32 process virtual address 

<offset> i= integer 

€length> :3:= integer 

<frame> t:= i. #100 

€<count> 222 1.42100 

€regid> 222 XitAiP 

Cregno> 222 00215i04.0F{16) 

Chex _vstring> 23:= 'thex string? 

€timed 232 1..12**31)-1 

€vystring> 232 "*charstring? 

<datatype> 22= HEXTASCIISASCI DECIMALS DEC 

<setector> 23= FULLIAUTOSSAVE 


F3.4¢e2.2 Command Descriptions 


Within the descriptions which follows optional parameters are 
enclosed in brackets. Defauit values for optional parameters are 
also defined. 


F304e20201 SET BREAKPOINT 


Selects a program interrupt which is to occur upon occurrence 
of a specified condition within a specified virtual -address 
rangee 


syntax: BP <name> <condition> [<base>] [<offset>] [<tength>] 


The base parameter is required when specifying a new 
breakpoint name; offset and length specifications are optional in 
this cases When adding a new condition selection to an existing 
breakpoints bases offsets and tlength parameters may not be 
specified. 


Bases offsets and fength parameters define the desired virtual. 
address range: <base> + <offset> yields ae first-—byte-address; 
first—byte—-address + <length> -1 yields a tast byte addresses 


Default parameter values: 


<offset>d: 0 
€length>: 1 
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F3e4e2e2e2 REMOVE BREAKPOINT 

Deselects a previously selected program interrupt. 
syntax: RB <named [<condition>] 

If only the name parameter is specifieds all conditions 
associated with the breakpoint are deselected and all evidence of 
the breakpoint is removed. If the condition parameter is 
specifieds only that condition is deselected; howevers if the 
specified condition is the only condition selecteds all evidence 
of the named breakpoint is removed. 

F3e4e2e20e3 LIST BREAKPDINT 


Provides a tist of currentty selected breakpoints and 
associated conditions.» : 


syntax: LB ([<name>d] 

If the name parameter is specifieds information is displayed 
for the named breakpoint onty. If the name parameter is not 
specifieds information is disptayed for alt currentiy defined 
breakpoints. 

F304020204 CHANGE BREAKPOINT 


Changes the virtual address range of a  previousty specified 
breakpoint. . 


syntax: CB <name> <based [<offset>] [<tength>) 

Bases offsets and tength parameters define the desired virtuai 
address range: <base> + <offset> yietds ai first-byte-address 3 
first-byte-address + <fength> -1 yields a last byte address. 


Default parameter values? 


<offset>: 0 
<length>: 1 


F304e2e225 TRACE BACK 


Provides information relevant to stack frames associated with 
an interrupted procedure and its predecessor proceduress 


Information displayed for each selected stack frame consists 
of? 
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- Stack frame number} 

— Current P-address of the associated procedure; 

~- Virtual address of the start of the stack frame; 
— Virtual address of the stack frame save areae 


syntax? TB (€<framed>] €<count>] 

The frame parameter specifies the number of the first stack 
frame for which information is to be displayed. {Stack frame 
number one is associated with the interrupted procedures stack 
frame two is associated with the interrupted procedure'ts 
predecessor, etc.) 


The count parameter specifies the total number of stack frames 
for which information is to be displayed. 


Default parameter vaiues: 


<frame>: 1 
€count>: 1 


F3040e2e226 DISPLAY STACK FRAME. 
Display selected information from a specified stack frame. 
syntax: DS U€<framed>] C<selector>] 


The frame parameter specifies the number of the stack frame 
for which information is to be displayed. (Stack frame number 


one is associated with the interrupted procedures stack frame two [6 
is associated with the interrupted procedure's predecessors A 
etc.) ee 


The selector parameter identifies a region of the specified 


stack frame: 66 4 


AUTO? Causes the automatic region of the stack frame to be 2 : 
displayed. ce 9 

SAVE: Causes the save area of the stack frame to be 13° 4/ 
displayed. | ‘ Ww 4 

FULL 3 Causes both the automatic and save areas of the stack: eo 
frame to be displayed. er 


Default parameter vatues:; 
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<frame>: 1 
€selector>d: FULL 


F304e2e227 DISPLAY REGISTER 


Display the contents of a specified register of an interrupted 
procedure. 


syntax: DR <regid> (<regnod] E<datatype>d]) 
Default parameter vatues: 


<regno>? O 
€datatype>d: HEX 


F304e20228 CHANGE REGISTER 


Sets a specified vatue into a specified register of an 
interrupted procedure. 


syntax: CR <regid> <regno> [<datatype>] <vstring> 
Default parameter values? 

<datatype>: HEX 2 “J a FE EAL 
F304e20209 DISPLAY MEMORY 

Displays the contents of a specified area of virtual memory. 

syntax? DM <based [<length>] 
Default parameter eaiaeea. randy 6 (6 Ee a fc 

<length>: 8 
F30e%e2e02210 CHANGE MEMORY 


Sets a specified value into a specified tlocation of virtual 
memorye 


v 
syntax? CM <base> <hex_vstring> 
F3e4%e2e22e11 RUN 


Invokes program execution after a selected program interrupt 
has occurred. 
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syntax? RUN <time> 


The time parameter specifies the maximum number of 
microseconds the program is to execute} a program interrupt will. 
occur upon attaining this execution ftimit. 


Default parameter values? 


<timed: infinite 


F3-5 ERROR CODES 


Error codes are displayed as 6 hex digits in the following 
format: 


AANNNN 


The AA field designates the functional area that issued the 
errore The possibie values are? 


01 ~ Signal Handier 

02 — Circular Buffer Handler 
03 —- Heap Manager 

04 ~— Misc Task Services 

05 — NZA 

06 ~ File Manager 

07 ~ N/A 

08 — Task Manager 

09 ~— Memory Manager 

OA —- Job Manager 

oC —- Loader 

0D —~ Central 170 

OE - Dispatcher 

OF — Command Language Processor 
10 ~ Logical Name Manager 
11 - Debug Processor 

12 ~ Configuration Manager 


The NNNN field is a detailed error number within the specified 
functional areas 
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F3e50e1 DETAILED ERROR CODES 


All numeric vatues are given in hexs 


F3.5.21.2.1 Signal Handier 


timeout 

signal buffer full 

task swapped 

invalid signal id 
incompatible signal type 
message buffer too smaifd 
empty wait list 


on # w# 6 HON 


F3e5e1.2 Circular Buffer Handier 


1 = buffer not initialized 
2 = buffer full 
3 = message too tong 


F3.5.1.3 Heap Manager 


None 


F3.2501.24 Misc Task Services 


None 


F3.2501.5 File Manager 


KFD not availabie 
File active 

File not active 
PFD not available 
File exists 

File not created 
File open 

Multiple usage 
File not temporary 
OA # File not permanent 
OB = File not attached 
OC = File attached 


OON OU SW NH 
HH # WH 8 Kk Hf oR on 
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OD = File not open 

OE = Invalid KFDL index 
OF = KFD not active 

10 = Invalid PFDL index 
11 = PFD not active 

12 = Active I70 

13 = No units configured 
14 = No active units 


F3.5e1-6 Task Manager 


1 = Task not found 


F3.5e1.7 Memory Manager 


Page already in page table 

Page tabie full 

No free pages 

Locked page free request. 

Page not in page table 

Invalid PVA 

Page frame not locked 

Page frame not assigned 

1E = N/A 

1F = Invalid ring number 

20 = Segment table is full 

21 = Segment number is in use 
= Segment number not in use 

23 = Nil segment pointer invalid 


OO aw oO OF & Wf pe 
iuw hae wh @ 


Segment number too big 
Cannot change segment number 
26 = Unsupported keyword 


F3e501.8 Job Manager 


None 


F3e5e21-9 Loader 


1 = program not found 
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F32521210 Central I/D 


IGRP not available 

End of file 

Invalid byte count 
Invalid buffer length 
Invalid buffer address 
Invalid MS function code 
Invalid CIO hardware type 
Feature not supported 


OW ou Pwr He 
re oe | 


9-40 = N/A 
41 End of device 
42 End of allocation 


0 

z= File not allocated 

* File atready allocated 
45 = Invalid cylinder 

= Invalid track 

=z Invalid sector 

= AUD not defined 

=z AUD allocated 

~- BO = N7A 

= CBD not available 


F3.5.1.211 Dispatcher 


Invatid task id 
PTL full 


1 
2 
3 Invalid running job ordinal 


F3e5e21212 Command Language. Processor 


missing parameter 
invalid character 
undefined parameter type 
integer out of range 
unknown command 
unknown syntax 

not supported 

bad parameter type 

token too f!ong 

bad combination of parameters 
bad vatue for pointer 
unknown parameter name 
valid password required 
SCB not event 


OON oO NS WN 
en © HH H WOW OW 


© 
it woe # # 
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F3.25.21.13 Logical Name Manager 


Entry not found 

Type mismatch on put 
Entry altready exists 
Illegal put request 
Buffer wrong size 
Buffer too small 


tH @ HH OH 


oO UU Wh me 


F3.521214 Debug Processor 


Debug not initialized 
Breakpoint name exists 

Base parameter not specified 
Invalid breakpoint condition 
Condition already selected 
Maximum number of breakpoints already set 
Invalid address range 

Invalid breakpoint name 
Condition not selected 

OA = No trap has occurred 

OB = Invatid stack frame specified 
OC = Register not in stack frame 


Oo wf OF UT wh me 
“tv # # WH HR OW fi 


OD = Invalid data type definition 
OF = Invalid register type 

OF = Invalid P-reg value 

10 = Invalid A-reg value 

11 = Invalid X-reg value 


12 = Invalid seftector 
3-OFE = N/A 
OFF = Unused error code 


F32501.215 Configuration Manager 


1 = Invalid function code 

2 = Not mass storage 

3 = Unit not active 

F32501216 CPU MONITOR 

These values are stored in register XE just before NOS/VE hafits 


the processor? 


1 = Hardware failure 
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2 = Task aborted in ring 1 or 2 

3 = Task aborted while abort in progress 
4 = Task executing had negative PIT 

301 = Hardware failure 
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F4.0 CODING CONVENTIONS AND SOURCE USAGE 


The conventions presented in this section refiect the current 
state of the NOS/VE systems formerly known as the Hardware 
Checkout System (HCS). The final NOS/VE system will differ from 
the current system in many wayss such as different functional 
areass new functional areass different naming conventionss etc. 
The conventions to be used in the final NOS/VE system are 
documented in the NOS/VE Project - Procedure and Conventions 
document. The information presented in this section is intended 
to assist users white HCS conventions are still in use. 


F4el NAMES 


Ail giobal NGS/VE names have the following format: 
AATSNNN 


The AA field designates the functional area to which the name 
applies, and can be one of the following: 


SH ~— Signal Handler 

HP — Heap Manager 

FM —- File Manager 

PM ~ Task Manager 

MM — Memory Manager 

JM - Job Manager 

il - Loader 

CI —- Central [70 

DS — Dispatcher 

CL —- Command Language Processor 
LN —- Logical Name Space Manager 
DB - Debug Processor 

CM — Configuration Manager 

DS - General NOS/VE 

MH —- Machine Code Breakout 

DM —- Data Management 

MT —- Monitor Interrupt Processor 


The T field represents the type of the names and can be one of 
the following values? 
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~ Procedure 
Variable 

Error Constant 

—- Keypoint Constant 


Ame vo 
i 


The NNN field is a descriptive string describing the object. 
F4.2 TEXT INPUT 


NOS7VE contains a routine that allows text input to be 
performed easiiys and without regard to whether execution is on 
the hardware or the simulator. When running on the simulator the 
system executes the IG machine instruction (opcode FF) which 
reads from the fife specified on the I parameter when the 
Simulator was caffed. When running on the hardwares text is 
input From the console. If more than one task attempts to read 
input at the same time when running on the simulators the "first! 
task will get the data. If this happens on the hardwares any one 
of the tasks may get the data. 


The name of the routine is CLPS$GET_STND_INP and has the 
following declaration? 


*#call RCLGETS 


The variable cstring contains the input text and is defined as 
follows: 


RECORD 

LHIsRHI 3 042255» 
S$ 3: STRING (255)>5 
RECEND; 


The LHI field points to the leftmost character of the string. 
Any number of blanks may precede the first character of the 
stringe A semicoton witli be added as the fast non biank 
character of the string and the RHI field will point to the 
semicolon. 


F4e3 TEXT OUTPUT 


NOS/VE contains a routine that allows text output to be 
performed easily», and without regard to whether execution is on 
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the hardware or the simulator. When running on the simulators 
the system executes the I0 machine instruction (opcode FF) which 
writes to the file specified on the QF =parameter when the 
Simulator was called. When running on the hardwares text is 
output to the dayfiles which is scrolled on the consote screen. 
If more than one task outputs to the consoles the outputs will be 
intermixed. NOS/VE does not identify the output as to which task 
issued it. 


The name of the routine is CLPSPUT_STND GUT and has the 
following declaration: 


*call RCLPUTS 
Note that the string S$ is a VAR parameters» and as suchs a 


literal string cannot be passed. 


F4.4 COMMAND UTILITIES 


NOS/VE contains various routines that will aid in the process 
of command cracking. The user could read a line of text input 
via CLPSGET_STND_INP and then use these utilities to crack the 
command tine. The following capabilities are available: 
CLPSCRACK_COMMAND — 


This routine uses a parameter descriptor tabie to crack the 
syntax of a commande A parameter value table is built specifying 
the actual values from the command. 

CLPSGET_TOKEN - 

This routine returns the next token from a command stringe 
PMPSASCII_LTO_BINARY — 

This routine converts an ASCII string to a binary vaiue. 


PMPSBINARY_TO_ASCII — 


This routine converts a binary number to its ASCII. 
representatione 


For more information on these routiness see a current source 
listing of theme 
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There are two ways to use these routines. Qne way would be to 
write auser task program which called on them directiy. The 
second way is to modify the NOS/VE command tanguage interface 
(routine CLP$3J0B_ COMMAND _PROCESSOR) to process the desired 
commands. This second method might remove the need for aieuser 
task program to aid in program checkout. 


NOS/VE provides a set of routines which externalize certain. 
hardware instructions to a CYBIL program. These routines are 
described fully in a DAP written by Jack Steiner. 


F4.5 PROGRAM HEADER DESCRIPTION 


When aeuser task is executed via the EXEC commands the text 
string portion of the command is made available to the program. 
Also» the program can set the status return variable and have it 
displayed by the system at task termination. 


This communication is performed via the parameters of the 
PROGRAM statements which has the following format? 


PROGRAM NAME (P = “STRING (255)3 
SL? 0.240963 
VAR STATUS 3 OSTSSTATUS)$ 


The P parameter points to the string specified on the EXEC 
commands and SL is the tength of the string. For internal 


program callss P can be dectared as a “CELL and then any 
structure can be passed. 


F406 COMMON DECK NAMING CONVENTIONS 


The generat format of a NOS/VE common deck name ist. 
XAANNNN 


The X fieid denotes the type of deck and is one of the 
following: 


T — TYPESCONST deck 
R - Procedure XREF deck 


The AA field denotes the functional area the deck deais with. 
The field may take on the same vaiues as the AA field described 
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in section 5.21. 


Then NNNN field contains the first four characters of the name 
of the item the deck represents. For XREF's it is the first. four 
characters from the descriptive part of the names ignoring the 
characters P$» # and _. For a TYPE/CONST deck the value will be 
TYPE. For a #TYPE/CONST deck defining tabies the value will be 
TBLS. 


Some examples would be- 
Deck name rmcompa from m#compare_swape 


Deck name rciputs from name cip$put_stnd_out. 


F4.7 IMPORTANT COMMON DECKS 


The following NOS/VE common decks are worthy of note:. 


TOSTYPE General OS definitions. 

THDWTYP — Hardware structure definitions. 
TMMTYPE — Memory management definitions. 
TSMTYPE Segment management definitions. 
TCLTYPE — Command ltanguage definitions. 


F4.8 DECK USAGE 


The following rules apply when using NOS/VE common decks! 


1) TYPEZCONST decks include al’ necessary keywords and end with a 
semicoton. 


2) Procedure XREF decks end with a semicolon. Other common decks 
may be required to define the types (for the parameters 
specified. 


3) Variable XREF decks do not contain the VAR keyword and end 
with a comma rather than a semicotone. Both the VAR keyword 
and ending semicolon must be suppiied in the surrounding 
text. Other common decks may be required to define the type 
symbol. 
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Keypoints are used to give an execution time trace of program 
flow by showing that a given function is being performed tieees 
that a given procedure is being executed). Keypoints are aiso 
used to display request parameterss status and error conditions. 


F5.1 SOURCE CODE CONVENTIONS 


The general format of the source statement used to generate a 
keypoint from a CYBIL program is: 


#INLINEC*KEYPOINT*»SEC TIONs DATA¥2565I1D)5 


The SECTION parameter identifies the Functional area that is 
issuing the keypoint. It must be in the range 1 to 15. The 
following values are currently defined: 


0 = Denotes a continuation of data from the previous 
keypoint (the occurance of a trap may not attow this 
feature to work correctiy). 
System information (ID numbers 1-63 are reserved for. 
use by assembler code routines) (O0SK$) 
Memory Manager (UMMKS$) 
Command Language {(CLK$) 
Debug (DBK$) 
Cio (Ccik$) 
File Manager (FMK$) 
Task Services (TSK$) 
Dispatcher (OSK$) 
Unused 
10= Job Manager (JMK$) 
11= Signal Handier {SHK$) 
12= Loader (LLK$) 
13-15 = Unused 


8 
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The DATA parameter can be any 24 bit or tess integer values 
and is normally used to display data that relates to a particular 
keypointe The value must be shifted fteft 8 bits (multiplied by 
256) so that it will not overtap with the ID valuee 
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The ID parameter is used to identify the keypoint within a 
section. The vatue must be in the range 0 to 255. Values less 
than 31 are considered criticals, unexpecteds unusuals etc. 


A user may add his own keypoints by using section 15 with. 
appropriate DATA and ID values. 


F5e2 KEYPOINT DATA USING THE HARDWARE 


A circular buffer of the tast 200 keypoints is maintained in. 
memory. These may be displayed an the console wsing the 
following command: 


DM <reai memory address of the buffer> 


The buffer is defined by the symbol OSVSKEYPOINT_ BUFFER» which 
will appear in the LINKMAP where the monitor tables are defined. 
The reali memory address is computed by adding the address of 
OSVSKEYPOINT_BUFFER to the length of the page table (monitor 
tables follow the page table). 


Keypoints produced on the hardware are not nearly as useful as 
simulator keypoints because only the f!tast 200 are available and 
they are displayed in an unedited format (i.e.» a hex memory 
dump). Howevers they can be useful in showing the sequence of 
events leading up to a system crashe 


The format of the keypoint buffer is an array of words with 
each word having the following format? 


Left 28 bits — Value of free running microsecond clock when the 
keypoint occured. 

Next 4 bits Keypoint class 

Next 24 bits Data valuee 

Next 8 bits — Keypoint id value 


F523 KEYPOINT DATA_USING THE SIMULATOR 


When executing on the simulators all keypoint instructions 
cause an entry to be added to the locat file SESSMKF. When 
execution is compfetes this file may be processed by a utility 
program to produce a listing of the keypoint information in a 
readabte Format. . ; 
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F5e301 KEYPOINT REFORMATTING UTILITY 


The SESSMKF file produced by the simulator can be reformatted. 
into a readable listing by executing the Following procedure? 


XEQsRNOSKEYE sBIUPRsfFNI) 


The 8 parameter, if presents causes the procedure to be run as 
a batch job. 


The FN parameter specifies the name of the file containing 
keypoint data. The default is SESSMKF. If this file is not a 
focal files or the procedure is running in batch modes the file 
will be obtained from the current catalog. 


The PR parameters if PE CSE OLS: causes the reformatted tisting 
to be sent to the printer. 


If run interactivelys when the procedure terminates the 
reformatted listing is on tocal file KEYFILE. 


| The RNGSKEY procedure requires two additional Files as input. 

The first file defines how the keypoint information is to be 
reformatted. The name of this file is KEYDESC and it is obtained 
from the current catalog ors if not present theres from the 
NOS/VE cataloge The format of this file is described in section 
Ge302 


The second input file provides directives to the utility 
program which direct its execution. The following directives are 
supported? 

CV MAXPROCID N 


This directive causes ali keypoints with id values greater 
than N to be ignorede. 


CV UNDEFINED 
This command causes both defined and undefined keypoints to be 
printed. An undefined keypoint is one that does not have a 
definition in the KEYDESC file. 
CV DEFINED 


This command causes only defined keypoints to be printed. 
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CV IDENT 


This command causes the keypoint processor to indent the 
output produced based on the NS fieid of the KEYDESC file. 


RUN 


This command causes the processor to make one pass over the 
keypoint file. It is used after the CV commands have specified 
how to process the keypoint information, 


END 


This command terminates the keypoint processor. [t must be 
the fast command. - . 


These directives are read from file RNOSKEZ. This file is 
obtained from the current catalog ors if not found theres from 
the NOS/VE catalog. 


F5.302 KEYPOINT DESCRIPTION FILE 


The keypoint description file is used by the keypoint 
reformatting utility to direct the reformatting of the keypoint 
information. Each tine in the file describes one keypoints, and 
has the following format: 


SID SCN PID LN F LEN FMT CSTR NS DT 


The SID field represents the section ID and is 2 characters 
Yong. An example would be MM for memory manager. 


The SCN fieid is the section class numbers which equals the 
SECTION vaiue from the keypoint instruction. 


The PID field is the procedure ID» which equais the ID value 
from the keypoint instruction. The SCN and PID vatues uniquely 
define a keypoint -—- ali of the other information is used for 
reformatting. 


The LN field is used to cause a line on the keypoint§ tisting 
to be preceeded by a * if the LN value is zeroe This feature is 
used to mark a given keypoint as special. 


The F field specifies that this is a special keypoint (Cleees 
has special meaning to the program that formats the keypoint 
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file). The values must be one of the following; 


~ Not special 

~- Task switch 
~ Begin trap 
End trap 

- Begin monitor 
— End monitor 


wm PWN O 
i 


Any new keypoint descriptions should specify this field as 
zero unless the utility program is modified to handie the new 
yaluels). 


The LEN Field specifies the length of the data portion of the 
keypoint in bytes.» 


The FMT field specifies in what format the data portion of the 
keypoint shoutd be displayeds and can be one of the following: 


H - Hex 
I —- Integer 
A - ASCII 


The CSTR fieitd is alto 8 character string describing the 
data portion of the keypoint. 


The NS field specifies the number of spaces to indent the DT 
string on the reformatted file. This feature can be used to show 
procedure nesting via keypoints. 


The DT fieitd is a text string that describes the purpose of 
the keypoint. It may fill the rest of the current tines 


The user may add his own keypoint descriptions to this file 
and save it in his cataloge When RNOSKEY Is runs the existing 
NOS/VE keypoints and user defined keypoints will be tisted 
together. If the NOS/VE keypoints are not wanteds their 
descriptions may be deleted from the file. 


F5.2323 REFORMATTED FILE DESCRIPTION 


The reformatted tisting file contains two sections. The first 
is asummary of the number of times each keypoint occurred. The 
second section is a fisting of all the keypoints in the order 
they were issuede Each tine of the second section has the 
following Format: 
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RT TSt DATA CSTR S$ TN SID OT 


The RT field designates the value of the free running 


microsecond clock (time since deadstart) when the keypoint was. 
executed, On the simulator the clock is incremented by 1 = for. 


each instruction executed. 


The TSL field designates the time (microseconds) since the 
last keypoint instruction was executed. 


The DATA field specifies the value of the data portion of the 
keypoint in the format described in the keypoint description fil 
for this keypoint. 


The CSTR fietd is the CSTR field from the keypoint description 
file for this keypoint. 


The S$ fieitd specifies the state of the machine when the 
keypoint was issued and is one of the following: 


M-— Monitor mode 
J - Job mode 


An * preceding the S field indicates that trap processing 


is actives ieee» the trap handter has been entered but. 


not exited, 


The T™N Fieid gives the global task id of the task that was 
executing when the keypoint was issuede The system is task i. 


The SID and DOT fields are just the SID and DT fields from the 
keypoint description file for this keypoints with the OT field 
indented as specified in the keypoint description. 


ae 
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Fos0 DEADSTART PROCEDURES 


Foel STAND ALONE DEADSTART (WITHOUT NOSZ170) 


o Set the PPS deadstart panel as follows: 
(Note that this is not the setting for the I0U) 


Location 2eitina iostruction 
i 7513 DCN 
2 2001 Loc 
3 0000 
4 7713 FNC 
5 0060 {(Warmstart read: 556 bpis 
unit 0) 
6 7413 ACN 
7 7113 IAM 
10 6200 


o Set SWEEP/LOAD/DUMP switch on the PPS panel to LOAD position. 
o Mount deadstart tape on unit O« 
o Verify that the 512 printer is READY. 


o Depress DEADSTART button at keyboard/dispiay console (the 
message "PROCEED" should appear on the teft screen). 


o Type SS (foilowed by a carriage return) to comptete system 
initialization. 


Foe2 DEADSTART WITH NOS/170 


This deadstart procedure uses the Common Test and 
Initialization (CTI) Facility of NOS/170 to deadstart NOS/VE. It 
requires two tape unitss one for the NOS/170 deadstart tape and 
one for the NOS/VE deadstart tape. 


Detaited information on the use of CTI is focated in chapter 2 


NOS/VE 
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of 


oO 


the NOS Version 1 Operators Guide (60435600 J). 
Set the deadstart panel as Follows: 
Location Setting 
1 0000 
2 0000 
3 0000 
4 75TT 
5 77TT 
6 EDDD 
7 T4TT 
i0 71TT 
11 7301 
12 RPXX 
13 RPXX 
14 0000 
TT is the channeit number of the tape unit containing the 
NOS/170 deadstart tape. 
€ is the equipment number of the tape controller. 
DDD is broken down as Follows: 
FFU 
FF specifies the type of unit being deadstarted from and is 
12 for 67X tapess 26 for 66X tapes and 3U for 844/885 
disks. 
U (or UU) is the unit number of the device. 
Words 12 and 13 (URPXX) can be ignored as they are onty used 
during NGS/170 deadstart. 
Mount the NOS/170 deadstart tape on the unit described by the 
deadstart panel settings. Mount the NOS/VE deadstart tape oan 
another unit. Press the deadstart button. The CTI *a*#. 
display should appear. 
Select the U (utilities) option. The CTI *U* display should 
appeare 
Select the A (alternate deadstart) option. CTI will ask for 


the device type», channels equipment and unit of the device to 
be deadstarted frome The vaiues supplied by the user should 
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be the ones for the NOS/VE deadstart tape unit. 


o The message "PROCEED™ should appear. Type "SS" to start 
NOS/VE. 
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F720 NOS/VE_TEST PROGRAMS 


NOS/VE has a set of programs which run as user tasks. These 
programs provide the following features: 


~ checking specific hardware features. 
- checking specific NOS/VE software features. 


—- creating a heavy and/or uniform load on the system. 


F7ol EXISTING TEST CASES 


F721.e1 SORT 
This program creates an array of records with random keyss 
then sorts this array and checks the results. 


The program allows a controltied amount of toad to be applied 
to the system paging mechanism. 


syntax: EX SORT "NR»yRS? 

NR —- The number of records to be created and sorted. 

RS ~- A factor affecting the size of each records By varying 
record sizes the user can change the ratio of CP time to I0 
time for a teste The approximate record size is given by 
the Formulas: 


3248 *RS 
F7.21.2 USER1 


This program will display the line: 


fuser task executing? 
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and then terminate. It is used to show that the system can at 
jeast execute a very small test case. 


syntax? EX AAAA #STRING? 
STRING -— If this parameter is presents it wilt be output after 
the tuser task executing’ messages 
F7ele3 VYUTL 
This program provides a variety of different test casess and 
also aiftows them to be run in a repetitive manner. 
syntax: EX YUTL FSTR!E 


STR - A string describing which program to run and how to run 
it. The various programs are described betow. 


F7e123e1 ENVSPEC 


This program generates an environment specification error. 
syntax? EX UUTL *"ENVSPEC® 


F7ele3e2 AROVEL 


This program generates an arithmetic overflow error. 
syntax: EX UUTL "AROVFL! 


F7.1.23.3 INSSPEC 


This program generates an instruction specification error. 
syntax: EX UUTL TINSSPEC?® 


This program generates a divide fault error. 


syntax: EX UVUTL "DIVFLT? 
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F701.2325 LA 


This program performs an LA (oad address) instruction on a 
specified PVA. It can be used to test various forms of memory 
protection. 


syntax: EX UUTL "LAs PVA? 
PVA -—- The virtual address to be toaded from. 


F701le326 SA 


This program performs an SA (store address) instruction on a 
specified PVA. It can be used to test various forms of memory 
protection. 


syntax: EX UUTL "SAs PVA! 
PVA ~ The virtual address to be stored into. 


F7ele3e7 RETURN 


This program modifies the previous stack frame area and then 
returns to see what effect the modifiction will have. 


syntax: EX UUTL 'RETURNgN! 
N — Modification option. Must be one of the following: 


—- Set value of A2 so it is not O mod Be. 

~ Set A2 bit 32 to l. 

~ Set A2 segment number invalid. 

- Set A3 segment number to segment without read accesse 

— Set P register segment number invalid. 

—- Set P register so it is not 0 mod 2. 

—- Set P register bit 32 to l. . 

— Set P register segment number to non executable 
segment. 

9 -—- Set final AO < > A2s 

10 - Cause VMID error. 

11 —- Cause inward return. 

12 - Cause return to C170 mode. 


ONO WR 
{ 
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F721.3.8 [TESTMEM 


This program creates,» writes and verifies an array of 
records. The record size is such that some records witli be 
located on a word boundarys some on all seven (other) byte 
boundariess some will cross pagess etc. 
syntax: EX UUTL 'TESTMEMsBC! 


BC ~ Number of bytes to be allocated to the records. The number 
of records created ist BC DIV 1741. 


F701.23-9 TESIMOVE 

This program is similar to TESTMEMs except that BDP 
instructions are used to compare and move records. 
syntax? €—X UUTL "TESTMOVE,BC* 


BC - Number of bytes to be allocated to the records. The number 
of records created is? BC DIV 255*2 + 1. 


F721.23210 RECURSE 


This program calls a procedure recursively. 
syntax? EX UUTL PRECURSEsN?*® 
N - The number of times to recursively call the procedure. 
F7.1.23-11 CYCLE 
This program cycles for a specified number of milliseconds. 
It can be used to load the system with 'idie tasks. 
syntax? EX UUTL *'CYCLE»MS* 
MS ~ The number of milliseconds to cycle for. 
F7.123212 TIMEDUI 


This program delays for a specified amount of time in 
increments. 
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syntax: EX UUTL 'TIMEOUTsTlsT2? 
Ti —- The number of milliseconds in each pmp$delay request. 
T2 - The total number of milliseconds delayed. 
F721.23213 LOOP 

This program toops (executes) for a specified amount of time. 
It can be used to load the system with active tasks. 
syntax: EX UUTL "'LODP» MS? 
MS — The number of milliseconds to execute fore 
F72123-214 A170 

This program creates a segment with reads writes execute and 
binding attributes» places C170 code into it and executes that 
code. The code executed counts down an X register and when it 
gets to zeros executes an ifitegal C170 instruction fop code 
0178). 
syntax: €X UUTL 'Al705N! 


N —- This value times 1000000 is placed in the X register being 
decremented to zero. 


F7.2123215 REPEAT 

This program synchronously executes a program a given number 
of times. 
syntax: EX UUTL ®REPEATsPNsNs? STR? 


PN —- Name of the program to executes It can be any program 
present in the NOS/VE tibrary. 


N —- The number of times to execute program PN, 
STR —- The parameter string passed to the program when it begins 


execution. Note the use of doubfie quote marks within a 
quoted string. 
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F721.23216 CALLER 


This program is simiiar to REPEATs but the tasks are run 
asynchronousiy. 


syntax: EX UUTL CALLER» PNoNs*STRI* 
The parameter definitions are the same as REPEAT. 


F7.1.3.17 BULK 


This program runs a number of different programs a specified 
number of times. This test is used primarily to toad the system 
with a random mix of programs. Some programs will terminate 
abnormally. 


syntax? EX UUTL tBULK»sN»X?* 


N - The number of times to execute the entire list. The 
Following programs (with parameters) are executed: 


LOOP»s5 

TIMEDUT 55 

CYCLEs5 

INSSPEC 

ADRSPEC 

ENVSPEC 

PRIVINS 
LA»s257800000000{16) 
$ As 100200000000(16) 
AROVFL 


X — If this parameter is specified lany value except 1) then the 
test will be run asynchronously —- that iss each test in the 
list wil! be started and after they are ail runnings the BULK 
test will wait for them ail to complete. This procedure is 
repeated N times. 


If this parameter is not specifieds or is specified as ls each 
test will be aliowed to comptete before the next test in the 
fist is started. 
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F701e3218 BULKNIC 
This program is similar to BULKs except that allo of the 
programs run are expected to complete normally. 
syntax? EX UUTL TBULKNTC»N»X? 
N — Same as for BULK» except the program tist is the following: 
LOOPs500 
LOOPs,5 
TIMEDUT 955500 
CYCLEs500 
RECURSE»s5000 
LOOPs10 
TESTMEMs 100000 
TES TMOVEs 100000 
LOOPs1000 
X — Same as for BULK. 


F701.23219 ADRSPEC 


This program causes an address specification error. 
Syntax? EX UUTL *ADRSPEC* 


F7e123-e20 PRIVINS 


This program causes a privileged instruction error. 


Syntax? EX UUTL *PRIVINS® 


F722 EXAMPLES 


To run the sort program on 1000 records of size 200 do?. 
EX SGRT £1000s200? 


To run 53 asynchronous copies of same sort test do? 
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EX VYUTL PCALLER»sSORTs53941000»,200!!? 
To run the same sort test 45 times in successions do 
EX UUTL PREPEATs SORT 9452410009200! 


HINT: When running programs which may run for a long period of 
times use the "A* option on the EX command. This runs the 
programs asychronousty with the command processore This 
allows you to status the test to see what is happening 
(TSTATUS»s PFSTATS) or to terminate the test if it runs too 
long (TMTERM). 
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